번역 작업 목록 조회

엔진, 상태, 트리거 또는 서비스 키로 작업을 찾고 커서 기반 페이지네이션으로 조회하세요.

조직 내에서 호출자가 볼 수 있는 작업 목록을 조회합니다:

http
GET /v2/organizations/:orgId/localization/jobs?limit=50
X-API-Key: YOUR_API_KEY

응답에는 작업 요약 배열인 data와 meta.nextCursor가 포함됩니다. nextCursor가 null가 될 때까지 커서를 따라 조회하세요. 빈 페이지가 반환되더라도 커서는 반드시 확인해야 합니다.

필터 #

매개변수의미
engineIds조회에 포함할 엔진 식별자.
statusesPending, Running, Completed, Failed 또는 Cancelled.
triggersapi, cli, ci, github, payload 또는 zendesk.
apiKeyIds서비스 키 식별자. 개인 키로 생성한 작업은 해당 사용자에게 귀속됩니다.
limit1부터 100까지의 정수. 기본값은 50입니다.
cursor이전 응답에서 반환된 불투명 커서.

여러 값을 지정하려면 statuses=Running&statuses=Failed처럼 배열 매개변수를 반복해서 사용하세요. 커서를 따라 조회하는 동안에는 필터를 그대로 유지하세요. 작업은 최신순으로 반환되며, 생성 시각이 같으면 작업 식별자로 순서를 결정합니다.

요약 필드 #

각 요약에는 id, organizationId, engineId, sourceLocale, trigger, status, createdAt, updatedAt, createdBy가 포함됩니다. 상태는 { "_tag": "Running" }처럼 태그가 지정된 객체이며, 실패 상태에는 message도 포함됩니다.

요약에는 문서와 출력 파일이 포함되지 않습니다. 문서 키, 대상 로캘, 단계별 진행 상황, 다운로드 주소를 확인하려면 id로 작업을 조회하세요.

가능하면 작업 생성 응답의 식별자를 자체 애플리케이션에 저장하세요. 목록 조회는 조사와 복구에 유용하지만, 작업 생성에 사용된 소스 리비전은 애플리케이션 자체 기록에 보관해야 합니다.