Skip to Content

잡 조회 API

워크플로우 실행 응답의 jobId로 실행 상태와 로그를 조회할 수 있어요.
조회할 때는 해당 Job을 만든 실행 요청과 같은 API Token을 사용해주세요.

Base URLhttps://api.deplite.io인증Authorization: Bearer dpl_...스코프워크플로우 실행 권한 · Job 생성 토큰

두 endpoint는 Job 생성에 사용한 토큰으로만 조회할 수 있어요.
Job ID가 없거나 다른 토큰으로 조회하면 404 job_not_found를 반환해요.
Job 조회 요청은 토큰별 polling rate limit을 적용하며 초과하면 429 rate_limited를 반환해요.

잡 상태 조회

GET/v1/jobs/{jobId}권한 워크플로우 실행 권한 · Job 생성 토큰

비동기 실행 요청에서 받은 jobId로 현재 상태와 결과를 확인해주세요.
queued와 running은 진행 중인 상태예요.
output, 종료 코드와 시각은 실행이 진행되는 동안 null일 수 있어요.

경로 파라미터

jobIdstring · uuid필수

조회할 Job ID예요.
다른 토큰의 Job은 조회할 수 없어요.

응답

성공하면 HTTP 200과 아래 필드를 돌려줘요.

jobIdstring · uuid

Job ID예요.

statusstring

현재 Job 상태예요.

허용 값queuedrunningsuccessfailedtimeoutrejectedcanceled
exitCodeintegernull 가능

종료 코드예요.

errorMessagestringnull 가능

실패 시 오류 메시지예요.

reasonstringnull 가능

거부 사유예요.

outputobjectnull 가능

워크플로우가 반환한 출력값이에요.

consoleUrlstring · URL

콘솔에서 Job을 여는 주소예요.

queuedAttimestamp

접수 시각이에요.

startedAttimestampnull 가능

실행 시작 시각이에요.

finishedAttimestampnull 가능

실행 종료 시각이에요.

오류

401
token_missing
Bearer 토큰이 없어요.
401
token_invalid
토큰이 무효·폐기·만료됐어요.
404
job_not_found
Job이 없거나 현재 토큰으로 조회할 수 없어요.
429
rate_limited
Job 조회 rate limit을 초과했어요.

공통 오류는 에러 코드에서 확인해주세요.

잡 로그 조회

GET/v1/jobs/{jobId}/logs권한 워크플로우 실행 권한 · Job 생성 토큰

로그는 seq가 작은 순서로 반환돼요.
다음 요청의 after에 응답의 nextAfter를 넣어 이어서 조회해주세요.
finished가 true면 Job이 종료된 상태예요.

경로 파라미터

jobIdstring · uuid필수

로그를 조회할 Job ID예요.
다른 토큰의 Job은 조회할 수 없어요.

쿼리 파라미터

afterinteger

이 seq보다 큰 로그부터 받아요.

0 ~ 2,147,483,647, 기본값 0
limitinteger

한 번에 받을 로그 수예요.

1 ~ 1000, 기본값 500

응답

성공하면 HTTP 200과 아래 필드를 돌려줘요.

itemsarray

요청한 범위의 로그예요.

seqinteger

로그 순번이며 다음 요청의 after 커서로 사용해요.

streamstring

로그 종류예요.

허용 값rawsystem
stepNamestringnull 가능

로그가 속한 step 이름이에요.

levelstring

로그 수준이에요.

허용 값infowarnerror
contentstring

로그 내용이에요.

eventAttimestamp

로그 발생 시각이에요.

nextAfterinteger

다음 페이지 요청의 after에 넣을 커서예요.

jobStatusstring

로그를 조회한 시점의 Job 상태예요.

허용 값queuedrunningsuccessfailedtimeoutrejectedcanceled
finishedboolean

Job이 종료 상태인지 나타내요.

오류

400
invalid_request
after 또는 limit 값이 허용 범위를 벗어났어요.
401
token_missing
Bearer 토큰이 없어요.
401
token_invalid
토큰이 무효·폐기·만료됐어요.
404
job_not_found
Job이 없거나 현재 토큰으로 조회할 수 없어요.
429
rate_limited
Job 조회 rate limit을 초과했어요.

공통 오류는 에러 코드에서 확인해주세요.

관련 문서

최종 수정 일자: