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

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

Nộp bài

Gửi kết quả gán nhãn theo định dạng Label Studio cho một lượt làm việc.

POST/questlab/sdk/v1/annotations?assignedTaskId={assignedTaskId}
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.
transactionIdheaderstringTuỳ chọnNên gửi, mỗi lượt nộp một mã, để đối soát từng lượt nộp.
Content-TypeheaderstringBắt buộcapplication/json
assignedTaskIdqueryUUIDBắt buộcMã lượt làm việc nhận được khi nhận nhiệm vụ.
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ú ý

  • assignedTaskId là query param, không phải path.
  • Gửi transactionId (mỗi lượt nộp một mã) để đối soát từng lượt nộp.
  • Sửa bài đã nộp: POST /questlab/sdk/v1/annotations/{annotationId} với id trả về.
  • Chỉ nộp được khi lượt làm việc còn PENDING và chưa quá expiredAt.

Request mẫu

POST /questlab/sdk/v1/annotations
bash
curl -X POST "$GW/questlab/sdk/v1/annotations?assignedTaskId=<assignedTaskId>" \
  -H "token: $ACCESS_TOKEN" \
  -H "transactionId: ACME-SUBMIT-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "result": [
      {
        "from_name": "label",
        "to_name": "image",
        "type": "rectanglelabels",
        "value": {
          "x": 10, "y": 20, "width": 30, "height": 40,
          "rotation": 0,
          "rectanglelabels": ["Product"]
        }
      }
    ],
    "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ý
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.
You have not permission.Lượt làm việc thuộc người dùng khác.Kiểm tra assignedTaskId và token thuộc cùng một người dùng.
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