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ê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ã.
X-Partner-CodeheaderstringTuỳ chọnMã đối tác để đối chiếu. Lệch với api-key thì nhận 403 (2013).
Content-TypeheaderstringBắt buộcapplication/json
assignedTaskIdpathUUIDBắt buộcMã lượt làm việc.
resultbodyarrayBắt buộcKết quả gán nhãn theo định dạng Label Studio.
lead_timebodynumberTuỳ chọnThờ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 result và lead_time, không bọc trong annotation.
  • Chỉ nộp được khi lượt làm việc còn PENDING và 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ểuMô tả
idUUIDMã bài nộp, dùng để sửa bài.
resultarrayKết quả đã lưu.
200 OK
json
{
  "status": true,
  "httpCode": 200,
  "data": {
    "id": "d4029aa4-f491-4042-b6dd-ad8f306ac195",
    "result": [ ... ]
  }
}

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.
2030assignedTaskId không tồn tại.Nhận nhiệm vụ mới.
2031Lượt làm việc không thuộc người dùng nào của đối tác.Không retry.
2032Lượt làm việc thuộc tài khoản tích hợp khác.Không retry.
httpCode 400Lượt làm việc đã hết hạn.Nhận nhiệm vụ mới.
httpCode 404Lượ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.
Cấu trúc response và lỗi dùng chung