완료 알림
작업이 끝난 것을 확인하는 방법입니다. 현재는 서버가 알려 주는 웹훅 대신 상태 조회로 확인합니다.
XBOSS 는 작업이 끝났을 때 고객 서버로 알림(웹훅)을 보내지 않습니다. 작업을 제출한 쪽에서 상태를 확인해 끝난 것을 압니다.
상태 응답에는 다음 확인까지 권하는 간격(retry_after_seconds)이 함께 오므로, 그 값만큼 기다렸다 다시 확인하면 됩니다.
- STEP 01제출
POST /v1/jobs 응답에서 job_id 를 받습니다.
- STEP 02상태 확인
GET /v1/jobs/{job_id} 로 진행 상황을 봅니다.
- STEP 03기다렸다 반복
retry_after_seconds 만큼 기다렸다 다시 확인합니다.
- STEP 04결과 조회
끝나면 결과를 가져오거나 오류를 처리합니다.
확인 간격
상태 응답의 retry_after_seconds 를 그대로 씁니다. 작업이 끝나면 이 값은 null 이 되고 progress 는 100 이 됩니다.
더 짧게 반복해도 결과가 빨리 나오지는 않습니다. 분당 요청 한도(기본 60회)에 먼저 걸립니다 — 환경.
오래 걸리는 작업
기관 접속이 필요한 작업은 수십 초가 걸릴 수 있습니다. 사용자 화면에서는 progress 와 progress_message 를 그대로 보여 주면 기다리는 이유를 알릴 수 있습니다.
작업 완료 웹훅이 필요하다면 서비스문의로 요구사항을 알려 주세요.