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

API bổ sung

Các API của kịch bản 1 dùng để xây màn danh sách, gợi ý, khám phá và hồ sơ. Tất cả gửi header token: {accessToken}.

MethodPathMục đích
Nhiệm vụ của tôi
GET/questlab/sdk/v1/assignmentsDanh sách lượt làm việc; lọc status, projectUuid
GET/questlab/sdk/v1/tasks/my-assigned?projectId={projectUuid}Nhiệm vụ của tôi trong một dự án, kèm statusCounts
Gợi ý nhiệm vụ
GET/questlab/sdk/v1/assignments/recommendations?limit=5Tối đa 5 gợi ý cho màn Home
POST/questlab/sdk/v1/assignments/recommendations/{recommendationId}/assignNhận đúng nhiệm vụ của thẻ gợi ý
Dự án
GET/questlab/sdk/v1/projects/discoverDanh sách dự án, dự án phù hợp xếp trước
GET/questlab/sdk/v1/projects/{projectId}Chi tiết dự án, gồm cấu hình nhãn
GET/questlab/sdk/v1/projects/contributedDự án đã từng tham gia
GET/questlab/sdk/v1/tasks/preview?projectUuid={projectUuid}Xem trước tối đa 10 nhiệm vụ
Chiến dịch
GET/questlab/sdk/v1/campaigns/publicDanh sách chiến dịch công khai
GET/questlab/sdk/v1/campaigns/{campaignUuid}Chi tiết chiến dịch
Hồ sơ
GET/auth/profileThông tin tài khoản
GET/auth/member-profileHồ sơ dùng để ghép dự án
PUT/auth/user/annotator-infoCập nhật nghề nghiệp và kỹ năng
GET/auth/user/annotator-info/occupationsDanh mục nghề nghiệp (không cần token)
GET/auth/user/annotator-info/skillsDanh mục kỹ năng (không cần token)

Bài kiểm tra đầu vào (khi gặp 1024)

Một số chiến dịch yêu cầu người dùng vượt qua bài kiểm tra trước khi nhận nhiệm vụ. Các API dưới đây có prefix /questlab/sdk/v1.

  1. 1GET /campaigns/{campaignId}/qualification/status: kiểm tra đã đạt chưa, có lượt thi đang mở (activeAttemptId) không, hay phải chờ (nextRetryAt).
  2. 2POST /campaigns/{campaignId}/qualification/attempts: bắt đầu hoặc tiếp tục lượt thi đang mở.
  3. 3GET /qualification/attempts/{attemptId}: đọc đề.
  4. 4PUT /qualification/attempts/{attemptId}/answers/{attemptQuestionId}: lưu từng câu trả lời với selectedOptionIds hoặc text.
  5. 5POST /qualification/attempts/{attemptId}/submit, sau đó GET .../result: nộp bài và xem kết quả. Đạt thì quay lại Nhận nhiệm vụ.