Mục lục tài liệu

Kịch bản 1: Người dùng định danh

Đọc nội dung nhiệm vụ

Lấy dữ liệu để hiển thị màn gán nhãn. Chỉ đọc được nhiệm vụ mà người dùng đang có lượt làm việc.

GET/questlab/sdk/v1/tasks/{taskUuid}
Kịch bản
1: Người dùng định danh
Xác thực
Header token: {accessToken} (Xác thực)

Tham số

TênVị tríKiểuBắt buộcMô tả
tokenheaderstringBắt buộcaccessToken của người dùng. Không dùng Authorization: Bearer.
taskUuidpathUUIDBắt buộctaskUuid nhận được khi nhận nhiệm vụ.

Cần chú ý

  • Các khoá trong data (image, text, audio...) phụ thuộc cấu hình từng dự án. Không giả định khoá cố định.
  • URL media là signed URL gắn với phiên: tải kèm header token và giữ nguyên query expires, signature.
  • Chỉ hiển thị từ annotations. Bỏ qua drafts và predictions nếu có trong response.

Request mẫu

GET /questlab/sdk/v1/tasks/{taskUuid}
bash
curl "$GW/questlab/sdk/v1/tasks/<taskUuid>" \
  -H "token: $ACCESS_TOKEN"

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ả
idUUIDMã nhiệm vụ.
dataobjectNội dung hiển thị; media là signed URL.
annotationsarrayBài đã nộp của chính người dùng; rỗng nếu chưa nộp.
annotations[].resultarrayKết quả gán nhãn đã nộp, để hiển thị lại.
assignedTasksarrayLượt làm việc của người dùng trên nhiệm vụ này, gồm status, expiredAt, remainingSeconds.
drafts, predictionsarrayKhông dùng.
200 OK
json
{
  "status": true,
  "httpCode": 200,
  "data": {
    "id": "0293ce6b-a126-11f1-be9f-ca561c08ad36",
    "data": {
      "image": "https://.../questlab/media/...?expires=...&signature=..."
    },
    "annotations": [],
    "assignedTasks": [
      {
        "id": "08119968-6c06-4b7e-88bb-70267cc0771f",
        "status": "PENDING",
        "expiredAt": "2026-09-17T07:17:28.446Z",
        "remainingSeconds": 259199
      }
    ]
  }
}

Mã lỗi

MãÝ nghĩaCách xử lý
httpCode 401Header token thiếu hoặc đã hết hạn.Làm mới phiên; thất bại thì khởi tạo lại qua backend.
Assignment not foundNgười dùng không có lượt làm việc trên nhiệm vụ này.Không mở màn gán nhãn; nhận nhiệm vụ mới.
Cấu trúc response và lỗi dùng chung