잡 조회 API
워크플로우 실행 응답의 jobId로 실행 상태와 로그를 조회할 수 있어요.
조회할 때는 해당 Job을 만든 실행 요청과 같은 API Token을 사용해주세요.
https://api.deplite.io인증Authorization: Bearer dpl_...스코프워크플로우 실행 권한 · Job 생성 토큰두 endpoint는 Job 생성에 사용한 토큰으로만 조회할 수 있어요.
Job ID가 없거나 다른 토큰으로 조회하면 404 job_not_found를 반환해요.
Job 조회 요청은 토큰별 polling rate limit을 적용하며 초과하면 429 rate_limited를 반환해요.
잡 상태 조회
/v1/jobs/{jobId}비동기 실행 요청에서 받은 jobId로 현재 상태와 결과를 확인해주세요.
queued와 running은 진행 중인 상태예요.
output, 종료 코드와 시각은 실행이 진행되는 동안 null일 수 있어요.
경로 파라미터
jobIdstring · uuid필수조회할 Job ID예요.
다른 토큰의 Job은 조회할 수 없어요.
응답
성공하면 HTTP 200과 아래 필드를 돌려줘요.
jobIdstring · uuidJob ID예요.
statusstring현재 Job 상태예요.
queuedrunningsuccessfailedtimeoutrejectedcanceledexitCodeintegernull 가능종료 코드예요.
errorMessagestringnull 가능실패 시 오류 메시지예요.
reasonstringnull 가능거부 사유예요.
outputobjectnull 가능워크플로우가 반환한 출력값이에요.
consoleUrlstring · URL콘솔에서 Job을 여는 주소예요.
queuedAttimestamp접수 시각이에요.
startedAttimestampnull 가능실행 시작 시각이에요.
finishedAttimestampnull 가능실행 종료 시각이에요.
오류
token_missingtoken_invalidjob_not_foundrate_limited공통 오류는 에러 코드에서 확인해주세요.
잡 로그 조회
/v1/jobs/{jobId}/logs로그는 seq가 작은 순서로 반환돼요.
다음 요청의 after에 응답의 nextAfter를 넣어 이어서 조회해주세요.
finished가 true면 Job이 종료된 상태예요.
경로 파라미터
jobIdstring · uuid필수로그를 조회할 Job ID예요.
다른 토큰의 Job은 조회할 수 없어요.
쿼리 파라미터
afterinteger이 seq보다 큰 로그부터 받아요.
limitinteger한 번에 받을 로그 수예요.
응답
성공하면 HTTP 200과 아래 필드를 돌려줘요.
itemsarray요청한 범위의 로그예요.
seqinteger로그 순번이며 다음 요청의 after 커서로 사용해요.
streamstring로그 종류예요.
rawsystemstepNamestringnull 가능로그가 속한 step 이름이에요.
levelstring로그 수준이에요.
infowarnerrorcontentstring로그 내용이에요.
eventAttimestamp로그 발생 시각이에요.
nextAfterinteger다음 페이지 요청의 after에 넣을 커서예요.
jobStatusstring로그를 조회한 시점의 Job 상태예요.
queuedrunningsuccessfailedtimeoutrejectedcanceledfinishedbooleanJob이 종료 상태인지 나타내요.
오류
invalid_requestafter 또는 limit 값이 허용 범위를 벗어났어요.token_missingtoken_invalidjob_not_foundrate_limited공통 오류는 에러 코드에서 확인해주세요.