문서

작업

버킷 업로드 등 비동기 작업으로 생성된 백그라운드 처리 작업을 추적하고 관리합니다.

작업 목록 조회

bash# 전체 작업
curl https://api.schift.io/v1/jobs \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

# 버킷별 필터
curl "https://api.schift.io/v1/jobs?bucket_id=abc123" \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

# 상태별 필터
curl "https://api.schift.io/v1/jobs?status=processing" \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

쿼리 파라미터	타입	설명
`bucket_id`	string	버킷별 작업 필터
`status`	string	상태별 필터: `queued`, `processing`, `completed`, `failed`

작업 조회

bashcurl https://api.schift.io/v1/jobs/{job_id} \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

작업 취소

처리 시작 전 대기 중인 작업을 취소합니다. 예약된 크레딧이 반환됩니다.

bashcurl -X POST https://api.schift.io/v1/jobs/{job_id}/cancel \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

{"status": "cancelled", "refunded": 0.25}를 반환합니다. 대기 중(queued)인 작업만 취소할 수 있으며, 이미 처리 중인 작업은 400을 반환합니다.

작업 재처리

실패한 작업을 재시도합니다. 원본 파일은 저장소에서 다시 처리됩니다.

bashcurl -X POST https://api.schift.io/v1/jobs/{job_id}/reprocess \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

작업 생명주기

작업은 queued → extracting → chunking → embedding → indexing → completed 순서로 진행됩니다. 중간에 실패하면 failed로 이동하고 재처리로 재시도할 수 있습니다.