ovahubGETBearer 토큰
작업 진행 상태 조회
/api/v1/tasks/:taskKey
소속 조직 작업의 영구 저장된 상태를 조회합니다. state와 공급업체 taskStatus는 의미가 다릅니다. 인증 정보나 지갑 서명은 반환하지 않습니다.
API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.
요청 예시
cURL
curl "https://tovahub.com/api/v1/tasks/server%3A507f1f77bcf86cd799439012%3Arestart%3Adocs_example_001" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.
매개변수
taskKey경로 · 필수string
8–240자이며 영문자, 숫자, 콜론, 밑줄 또는 하이픈을 허용합니다. 반환된 taskKey를 그대로 사용하세요.
응답
HTTP 상태 200
조직에 이미 존재하는 작업의 영구 저장 상태를 조회합니다.
taskKeystring플랫폼 작업의 고정 키입니다.
actionstring기록된 작업 이름입니다.
statestring ('started' | 'succeeded' | 'failed')플랫폼 측 작업 상태로, 공급업체 작업 상태와 다릅니다.
pendingboolean플랫폼 또는 공급업체 측 완료 여부가 확정되지 않은 동안 true입니다.
localFinishPendingboolean스냅샷 요청이 succeeded이고 저장된 응답과 유효한 완료 시각이 있으며 공급업체 작업 ID가 없고 로컬 접수 후처리가 남아 있으면 true입니다. 원래 action과 requestKey로 recover_snapshot을 호출하세요. 작업 GET은 읽기 전용입니다.
taskIdstring | null공급업체 작업 식별자이며, 있는 경우에만 제공됩니다.
taskStatusstring | null마지막으로 관측된 공급업체 작업 상태입니다.
errorstring | null민감한 정보를 제거한 기록 오류이며, 있는 경우에만 제공됩니다.
createdAtstring (ISO 8601)플랫폼 측 작업 생성 시각입니다.
finishedAtstring (ISO 8601) | null플랫폼 측 완료 시각이며, 있는 경우에만 제공됩니다.
actorUserIdstring (ObjectId) | null원래 작업자의 계정 ID이며 불완전한 기록은 null입니다. 현재 독자는 동일한 고정 팀의 활성 구성원이어야 합니다.