Mục lục tài liệu
Kịch bản 2: Khách vãng lai
Danh sách nhiệm vụ (guest)
Danh sách lượt làm việc của một thiết bị, cùng cấu trúc với GET /questlab/sdk/v1/assignments.
GET
/questlab/integration/guest/assignments- 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ã. |
deviceId | query | string | Bắt buộc | Mã thiết bị. |
status | query | string | Tuỳ chọn | PENDING, ANNOTATED, EXPIRED hoặc CANCELLED; bỏ trống để lấy tất cả. |
projectUuid | query | UUID | Tuỳ chọn | Lọc theo dự án. |
page | query | number | Tuỳ chọn | Bắt đầu từ 1, mặc định 1. |
pageSize | query | number | Tuỳ chọn | Mặc định 20. |
Cần chú ý
- Thiết bị chưa nhận nhiệm vụ nào thì trả về trang rỗng, không phải lỗi.
totallà tổng số bản ghi khớp bộ lọc, dùng để phân trang.
Request mẫu
GET /questlab/integration/guest/assignments
bash
curl -G "$GW/questlab/integration/guest/assignments" \
-H "x-api-key: $API_KEY" \
-H "transactionId: ACME-GUEST-0002" \
--data-urlencode "deviceId=8201b4a3396c4ea6" \
--data-urlencode "status=PENDING" \
--data-urlencode "page=1" \
--data-urlencode "pageSize=20"Biến $GW, $API_KEY, $ACCESS_TOKEN được giải thích ở trang Xác thực.
Response
| Trường trong `data` | Kiểu | Mô tả |
|---|---|---|
items | array | Các lượt làm việc. |
items[].annotationCount | number | Số bài nhiệm vụ đã nhận từ mọi người. |
items[].overlap | number | Số bài cần để nhiệm vụ hoàn thành. |
items[].remainingSeconds | number | Chỉ có nghĩa khi status = PENDING. |
total, page, pageSize | number | Thông tin phân trang. |
serverTime | datetime | Một mốc cho cả trang, để bù lệch đồng hồ. |
200 OK
json
{
"status": true,
"httpCode": 200,
"data": {
"items": [
{
"assignedTaskId": "08119968-6c06-4b7e-88bb-70267cc0771f",
"taskUuid": "0293ce6b-a126-41f1-be9f-ca561c08ad36",
"projectUuid": "95812f4f-915e-41f1-be9f-ca561c08ad36",
"status": "PENDING",
"assignedAt": "2026-09-14T07:17:28Z",
"expiredAt": "2026-09-17T07:17:28Z",
"annotationCount": 0,
"overlap": 3,
"remainingSeconds": 258000
}
],
"total": 1,
"page": 1,
"pageSize": 20,
"serverTime": "2026-09-14T07:20:00Z"
}
}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. |
httpCode 400 | page nhỏ hơn 1 hoặc deviceId rỗng. | Sửa tham số. |
