UnifiedJob

작업 상태 조회

GET /v1/jobs/{job_id} 작업 상태 조회.

응답 분기: - 작업 발견 (정책 통과 + 동일 org/env) → 200 OK + 응답 10필드 - 잡 부재 (또는 다른 org/env) → 404 JOB_NOT_FOUND (정보 노출 차단) - 정책 거부 (AuthPolicyError) → 401/402/403/422/429 - PrincipalContext.organization_id None → 400 VALIDATION_INVALID_FIELD (데이터 손상 운영 진단 — 외부 silent 500 fallback 차단) - 잘못된 job_id 형식 → 400 VALIDATION_INVALID_FIELD - 그 외 예외 → 500 INTERNAL_ERROR

get/v1/jobs/{job_id}

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/jobs/{job_id}
  • 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)

Path parameters

job_idstring required

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
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 입니다.

Response

Successful Response

job_idstring required
statusstring required

QUEUED · RUNNING · SUCCEEDED · FAILED · TIMEOUT 등.

env_scopestring required
providerstring required
actionstring required
submitted_atstring required

KST ISO-8601.

started_atstring nullable

시작 전이면 없다.

finished_atstring nullable

끝나기 전이면 없다.

retry_countinteger required
progressinteger nullable

0~100. 값과 문구는 MCP(SSE)와 같은 한 곳에서 온다(job_progress).

progress_messagestring nullable

지금 무엇을 하고 있는지 한국어 한 줄.

retry_after_secondsinteger nullable

다음 조회까지 기다릴 초. 끝난 작업에는 없다.

Changes

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