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ê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ã.
deviceIdquerystringBắt buộcMã thiết bị.
statusquerystringTuỳ chọnPENDING, ANNOTATED, EXPIRED hoặc CANCELLED; bỏ trống để lấy tất cả.
projectUuidqueryUUIDTuỳ chọnLọc theo dự án.
pagequerynumberTuỳ chọnBắt đầu từ 1, mặc định 1.
pageSizequerynumberTuỳ chọnMặ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.
  • total là 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ểuMô tả
itemsarrayCác lượt làm việc.
items[].annotationCountnumberSố bài nhiệm vụ đã nhận từ mọi người.
items[].overlapnumberSố bài cần để nhiệm vụ hoàn thành.
items[].remainingSecondsnumberChỉ có nghĩa khi status = PENDING.
total, page, pageSizenumberThông tin phân trang.
serverTimedatetimeMộ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ĩ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.
httpCode 400page nhỏ hơn 1 hoặc deviceId rỗng.Sửa tham số.
Cấu trúc response và lỗi dùng chung