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ên | Vị trí | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
token | header | string | Bắt buộc | accessToken của người dùng. Không dùng Authorization: Bearer. |
taskUuid | path | UUID | Bắt buộc | taskUuid 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
tokenvà giữ nguyên queryexpires,signature. - Chỉ hiển thị từ
annotations. Bỏ quadraftsvàpredictionsnế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ểu | Mô tả |
|---|---|---|
id | UUID | Mã nhiệm vụ. |
data | object | Nội dung hiển thị; media là signed URL. |
annotations | array | Bài đã nộp của chính người dùng; rỗng nếu chưa nộp. |
annotations[].result | array | Kết quả gán nhãn đã nộp, để hiển thị lại. |
assignedTasks | array | Lượt làm việc của người dùng trên nhiệm vụ này, gồm status, expiredAt, remainingSeconds. |
drafts, predictions | array | Khô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ĩa | Cách xử lý |
|---|---|---|
httpCode 401 | Header 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 found | Ngườ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. |
