Mục lục tài liệu
Kịch bản 2: Khách vãng lai
Mở lại nhiệm vụ (guest)
Đọc lại nhiệm vụ đang làm dở theo assignedTaskId, ví dụ khi ứng dụng khởi động lại.
GET
/questlab/integration/guest/tasks/{assignedTaskId}- Kịch bản
- 2: Khách vãng lai
- Xác thực
x-api-key+transactionId, gọi từ backend (Xác thực)
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
x-api-key | header | string | Bắt buộc | Api key do QuestLab cấp. Chỉ gửi từ backend có địa chỉ IP đã đăng ký. |
transactionId | header | string | Bắt buộc | Khoá đối soát do bạn đặt, mỗi lượt gọi một mã. |
assignedTaskId | path | UUID | Bắt buộc | Mã lượt làm việc đã lưu. |
Request mẫu
GET /questlab/integration/guest/tasks/{assignedTaskId}
bash
curl "$GW/questlab/integration/guest/tasks/<assignedTaskId>" \
-H "x-api-key: $API_KEY" \
-H "transactionId: ACME-GUEST-0003"Biến $GW, $API_KEY, $ACCESS_TOKEN được giải thích ở trang Xác thực.
Response
Cùng cấu trúc với Nhận nhiệm vụ (guest), dùng chung một model.
200 OK
json
{
"status": true,
"httpCode": 200,
"data": {
"partnerCode": "ACME",
"deviceId": "8201b4a3396c4ea6",
"questlabUserId": "15603676-f0ea-4fe9-9d04-cf07901728f0",
"transactionId": "ACME-GUEST-0001",
"assigned": true,
"assignedTaskId": "08119968-6c06-4b7e-88bb-70267cc0771f",
"taskUuid": "0293ce6b-a126-41f1-be9f-ca561c08ad36",
"projectUuid": "95812f4f-915e-41f1-be9f-ca561c08ad36",
"expiredAt": "2026-09-21T07:17:28.446Z",
"task": {
"id": "0293ce6b-a126-41f1-be9f-ca561c08ad36",
"data": { "image": "https://.../questlab/media/...?expires=...&signature=..." },
"annotations": [],
"assignedTasks": [
{ "id": "08119968-6c06-4b7e-88bb-70267cc0771f", "status": "PENDING", "expiredAt": "2026-09-21T07:17:28.446Z" }
]
},
"message": "Task assigned successfully."
}
}Mã lỗi
| Mã | Ý nghĩa | Cách xử lý |
|---|---|---|
HTTP 401 | x-api-key sai hoặc hết hạn, hoặc IP gọi tới chưa được đăng ký. | Kiểm tra cấu hình, không retry. Liên hệ QuestLab nếu cần. |
2021 | Thiếu header transactionId. | Bổ sung header. |
2030 | assignedTaskId không tồn tại. | Nhận nhiệm vụ mới. |
2031 | Lượt làm việc không thuộc người dùng nào của đối tác. | Không retry. |
2032 | Lượt làm việc thuộc tài khoản tích hợp khác. | Không retry. |
