Mục lục tài liệu
Kịch bản 2: Khách vãng lai
Nộp bài (guest)
Gửi kết quả gán nhãn cho một lượt làm việc của thiết bị.
POST
/questlab/integration/tasks/{assignedTaskId}/submit- 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ã. |
X-Partner-Code | header | string | Tuỳ chọn | Mã đối tác để đối chiếu. Lệch với api-key thì nhận 403 (2013). |
Content-Type | header | string | Bắt buộc | application/json |
assignedTaskId | path | UUID | Bắt buộc | Mã lượt làm việc. |
result | body | array | Bắt buộc | Kết quả gán nhãn theo định dạng Label Studio. |
lead_time | body | number | Tuỳ chọn | Thời gian làm bài, tính bằng giây. |
result theo định dạng Label Studio; bảng khoá theo từng loại nhãn nằm ở Quy ước & mã lỗi.
Cần chú ý
- Body phẳng gồm
resultvàlead_time, không bọc trongannotation. - Chỉ nộp được khi lượt làm việc còn
PENDINGvà chưa quáexpiredAt.
Request mẫu
POST /questlab/integration/tasks/{assignedTaskId}/submit
bash
curl -X POST "$GW/questlab/integration/tasks/<assignedTaskId>/submit" \
-H "x-api-key: $API_KEY" \
-H "transactionId: ACME-GUEST-0004" \
-H "Content-Type: application/json" \
-d '{
"result": [
{
"from_name": "label",
"to_name": "image",
"type": "rectanglelabels",
"value": {
"x": 10.5, "y": 20.5, "width": 30, "height": 40,
"rotation": 0,
"rectanglelabels": ["Cat"]
}
}
],
"lead_time": 12.5
}'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ã bài nộp, dùng để sửa bài. |
result | array | Kết quả đã lưu. |
200 OK
json
{
"status": true,
"httpCode": 200,
"data": {
"id": "d4029aa4-f491-4042-b6dd-ad8f306ac195",
"result": [ ... ]
}
}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. |
2030 | assignedTaskId không tồn tại. | Nhận nhiệm vụ mới. |
2031 | Lượt làm việc không thuộc người dùng nào của đối tác. | Không retry. |
2032 | Lượt làm việc thuộc tài khoản tích hợp khác. | Không retry. |
httpCode 400 | Lượt làm việc đã hết hạn. | Nhận nhiệm vụ mới. |
httpCode 404 | Lượt làm việc đã được nộp trước đó. | Không nộp lại; dùng API sửa bài nếu cần. |
