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ênVị tríKiểuBắt buộcMô tả
x-api-keyheaderstringBắt buộcApi key do QuestLab cấp. Chỉ gửi từ backend có địa chỉ IP đã đăng ký.
transactionIdheaderstringBắt buộcKhoá đối soát do bạn đặt, mỗi lượt gọi một mã.
assignedTaskIdpathUUIDBắt buộcMã 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ĩaCách xử lý
HTTP 401x-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.
2021Thiếu header transactionId.Bổ sung header.
2030assignedTaskId không tồn tại.Nhận nhiệm vụ mới.
2031Lượt làm việc không thuộc người dùng nào của đối tác.Không retry.
2032Lượt làm việc thuộc tài khoản tích hợp khác.Không retry.
Cấu trúc response và lỗi dùng chung