MOBILE-ID · TRUSTED LTANS
API tác vụ
Theo dõi QUEUED, RUNNING, chờ phụ thuộc và kết quả; dùng resultReference mà không nhầm SUCCEEDED với VALID.
MÔ PHỎNG CỤC BỘ · Hợp đồng mục tiêu · Không gửi yêu cầu mạng
GET/v1/jobs/{jobId}
HỢP ĐỒNG MỤC TIÊU · API 3.0.0-draft
| Thuộc tính | Giá trị |
|---|---|
| Chủ sở hữu kỹ thuật | Dịch vụ lưu trữ |
| Quyền ứng dụng | jobs:read |
| HTTP | 200 |
| Xử lý lời gọi | Xác thực/quyền → xử lý HTTP; đây không phải enum trạng thái tài nguyên. |
| Sự kiện | Nhật ký hoặc sự kiện nội bộ |
Kiểm tra jobId và tổ chức; timeout không đồng nghĩa thất bại.
curl --fail-with-body --request GET \
"${BASE_URL%/}/v1/jobs/${JOB_ID}" \
--header "Authorization: Bearer ${ACCESS_TOKEN}" \
--header "X-Correlation-ID: ${CORRELATION_ID}"{
"jobId": "job-transfer-001",
"state": "SUCCEEDED",
"resourceId": "trf-test-001",
"correlationId": "corr-test-001",
"pollAfterSeconds": 2,
"resultReference": "/v1/transfers/trf-test-001"
}{
"type": "object",
"properties": {
"jobId": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"QUEUED",
"RUNNING",
"WAITING_EXTERNAL",
"RETRY_PENDING",
"SUCCEEDED",
"FAILED",
"CANCELLED"
]
},
"resourceId": {
"type": "string"
},
"correlationId": {
"type": "string"
},
"pollAfterSeconds": {
"type": "integer",
"minimum": 1
},
"resultReference": {
"type": "string",
"description": "URI reference to the completed resource, for example /v1/verifications/ver-test-001. Resolve only against the configured API origin."
},
"error": {
"$ref": "#/components/schemas/Problem"
}
},
"required": [
"jobId",
"state",
"correlationId"
],
"additionalProperties": false,
"examples": [
{
"jobId": "job-transfer-001",
"state": "SUCCEEDED",
"resourceId": "trf-test-001",
"correlationId": "corr-test-001",
"pollAfterSeconds": 2,
"resultReference": "/v1/transfers/trf-test-001"
}
]
}{
"type": "https://example.invalid/problems/job-not-found",
"title": "Job Not Found",
"code": "JOB_NOT_FOUND",
"detail": "Job is not visible in the current tenant.",
"correlationId": "corr-test-001",
"requestId": "req-test-001",
"retryable": false,
"service": "Archive Service",
"timestamp": "2026-10-15T05:00:01Z",
"errors": [],
"status": 404,
"instance": "urn:ltans:request:req-test-001"
}