단일 API에서 3단계 Choreography 구조로 변경된 ASC 리뷰 제출 워크플로우 분석

The ASC API's 3-step review submission flow (and why appStoreVersionSubmissions is gone)

孫昊2026년 5월 7일6분intermediate

AI 요약

Context

기존 /appStoreVersionSubmissions 엔드포인트의 단일 요청 기반 제출 방식이 Deprecated 처리됨에 따라 자동화 스크립트의 중단 발생. 단순 제출 구조로는 다중 버전 배치 처리 및 제출 전 메타데이터 수정 등의 유연한 제어가 불가능한 한계 존재.

Technical Solution

Resource Container 개념 도입을 통한 /reviewSubmissions 생성 단계 분리
Submission ID 기반의 /reviewSubmissionItems 매핑을 통한 다중 버전 배치(Batch) 지원 구조 설계
최종 상태 변경을 위한 PATCH /reviewSubmissions/{id} 요청으로 제출 시점 제어
State Machine 방식의 단계적 상태 전이(Container 생성 $\rightarrow$ Item 연결 $\rightarrow$ 제출 플래그 활성화) 적용
API 응답 순서 의존성 해결을 위해 Shell 기반 파일 저장 방식에서 Python 메모리 기반 상태 관리 체계로 전환

실천 포인트

1. ASC API 자동화 시 /appStoreVersionSubmissions 대신 3단계 flow 적용 여부 확인

2. 단계 간 의존성으로 인한 422 Error 방지를 위해 엄격한 호출 순서 보장

3. 중간 단계 실패 시 복구를 위해 Submission ID의 즉각적인 로깅 및 상태 저장 로직 구현

4. 네트워크 불안정성에 대비한 Exponential Backoff 기반의 Retry 핸들러 적용

태그

#Choreography #Automation #Batch Processing #State Management #API Design

원문 읽기