Biên nhận bất đồng bộ
HTTP 202 trả mã tác vụ để theo dõi; nó không xác nhận bằng chứng đã hoàn tất.
MOBILE-ID · TRUSTED LTANS
Tác vụ bất đồng bộ
Xử lý timeout, chờ phụ thuộc, thử lại và tham chiếu kết quả mà không tạo giao dịch trùng.
Tách thời gian HTTP khỏi vòng đời tác vụ
Kết nối bị gián đoạn
Truy vấn tác vụ cũ hoặc đối soát bằng khóa chống lặp trước khi gửi lại lệnh.
Trạng thái và hành động
QUEUEDRUNNINGSUCCEEDEDNgoại lệ: WAITING_EXTERNAL / RETRY_PENDING / FAILED / CANCELLED
| Trạng thái | Ý nghĩa và bước tiếp theo |
|---|---|
| QUEUED | Đã nhận tác vụ, chờ tài nguyên xử lý. |
| RUNNING | Đang xử lý; chưa có kết quả cuối. |
| WAITING_EXTERNAL | Chờ kho, TSA hoặc phụ thuộc ngoài. |
| RETRY_PENDING | Đã lên lịch thử lại có giới hạn. |
| SUCCEEDED | Đọc tham chiếu kết quả; không suy ra mọi loại bằng chứng đều hợp lệ. |
| FAILED | Đọc Problem và đối soát nguyên nhân trước tạo lệnh mới. |
| CANCELLED | Đã hủy tác vụ theo khả năng/quyền của môi trường. |
Theo dõi đến tài nguyên kết quả
GET /v1/jobs/job-test-001
{
"jobId": "job-test-001",
"state": "SUCCEEDED",
"resourceId": "ver-test-001",
"correlationId": "corr-test-001",
"resultReference": "/v1/verifications/ver-test-001"
}Với kiểm chứng, truy cập resultReference để đọc báo cáo; HTTP thành công vẫn có thể trả báo cáo INDETERMINATE. Chỉ giải quyết tham chiếu trên API origin đã được cấu hình.
Thử lại có kiểm soát
- Tuân theo
pollAfterSecondsvà Retry-After nếu được cung cấp; không thăm dò vòng lặp liên tục. - Giữ mã tương quan để hỗ trợ đối soát; không ghi token vào nhật ký.
- Cửa sổ chống lặp, thời gian chờ và số lần thử được xác nhận theo môi trường, không phải SLA mặc định.
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.
Danh mục lỗi
Chẩn đoán lỗi theo thao tác, phân biệt lỗi HTTP với kết quả kiểm chứng và chọn cách phục hồi.
Đọc hướng dẫn tích hợp →
Bộ ca thử nghiệm tích hợp
Các ca thành công, gửi trùng, thiếu dữ liệu, lỗi TSA, webhook và chuyển giao cùng tiêu chí mong đợi.
Đọc hướng dẫn tích hợp →Tách ba loại trạng thái
| Đối tượng | Ví dụ | Không được suy ra |
|---|---|---|
Job | SUCCEEDED | Không tự suy bằng chứng hợp lệ. |
ArchiveObject | EVIDENCE_READY | Không tự suy mọi lần kiểm chứng độc lập đều VALID. |
VerificationReport | INDETERMINATE | Không tự coi là lỗi HTTP hoặc dữ liệu sai. |