CompositePack

묶음 실행 제출 (202 + 폴링)

묶음 실행을 접수하고 바로 돌려준다(기관 호출이 끝나기를 기다리지 않는다).

새로 접수하면 202, 같은 Idempotency-Key 와 같은 본문으로 다시 보내면 200 으로 그 실행의 지금 상태를 돌려준다(단일 작업 제출과 같은 규칙이다). 접수한 뒤에는 GET /v1/packs/{pack_run_id} 로 끝날 때까지 조회한다.

post/v1/packs

Request

  • Base URL: https://api.xdata.kr (the document declares no server; this is the origin it was published from)
  • URL: https://api.xdata.kr/v1/packs
  • Auth: one of:
    • HTTP basic
    • OAuth 2 (authorization code, authorization URL https://api.xdata.kr/oauth/authorize, token URL https://api.xdata.kr/oauth/token)

Query parameters

env_scope'production' | 'real_test' | 'sandbox' nullable

환경을 고릅니다. 값은 production · real_test · sandbox 중 하나입니다. 경로 접두(/v1/sandbox/... · /v1/test/... · /v1/production/...) · X-Env-Scope 헤더 · env_scope 쿼리 가운데 한 통로로 반드시 보내야 합니다. 빼면 자동으로 채우지 않고 거절하며, 두 통로에 서로 다른 값을 담아도 거절합니다. 거절은 HTTP 422 이고 오류 코드는 VALIDATION_ENV_SCOPE_MISMATCH 입니다.

Headers

Authorizationstring nullable
Idempotency-Keystring nullable
User-Agentstring nullable
X-Env-Scope'production' | 'real_test' | 'sandbox' nullable

환경을 고릅니다. 값은 production · real_test · sandbox 중 하나입니다. 경로 접두(/v1/sandbox/... · /v1/test/... · /v1/production/...) · X-Env-Scope 헤더 · env_scope 쿼리 가운데 한 통로로 반드시 보내야 합니다. 빼면 자동으로 채우지 않고 거절하며, 두 통로에 서로 다른 값을 담아도 거절합니다. 거절은 HTTP 422 이고 오류 코드는 VALIDATION_ENV_SCOPE_MISMATCH 입니다.

Request body

providerstring required

팩 provider (조합 상품)

actionstring required

팩 action

paramsobject nullable

팩 파라미터 (선택). 실행기가 leg 로 나눠 쓴다.

Response

같은 멱등키와 같은 본문으로 다시 보낸 요청 - 그 실행의 지금 상태다.

pack_run_idstring required

묶음 실행 번호. 상태 조회와 결과 파일 삭제의 주소에 쓴다.

statusstring required

RUNNING, SUCCEEDED, FAILED, TIMEOUT 중 하나.

env_scopestring required

요청한 환경 그대로. sandbox, real_test, production 중 하나.

providerstring required
actionstring required
submitted_atstring nullable

KST ISO-8601. 접수한 시각.

completed_atstring nullable

KST ISO-8601. 끝나기 전이면 없다.

progressinteger nullable

0~100. 값과 문구는 단일 작업 조회와 같은 규칙에서 온다.

progress_messagestring nullable

지금 무엇을 하고 있는지 한국어 한 줄. 끝난 실행에는 없다.

retry_after_secondsinteger nullable

다음 조회까지 기다릴 초. 끝난 실행에는 없다.

Changes

No recorded changes to this operation across all 1 revision of this API.