Lấy câu hỏi theo Part

Lấy danh mục câu hỏi Speaking theo Part 1, 2 hoặc 3.

Request

Field	Type	Giá trị mẫu	Bắt buộc	Mô tả
part	query parameter	`1`	tuỳ chọn	Lọc theo Part. Bỏ trống thì trả về toàn bộ câu hỏi. Lệnh ví dụ dùng sẵn part=1; đổi sang 2 hoặc 3 nếu bạn cần Part khác.

Response

Envelope { data, meta } của AIHUB. data.part là Part đã lọc, data.questions là danh sách câu hỏi, mỗi câu có question_id, part, prompt_text và audio_url là bản ghi câu trả lời mẫu cho câu hỏi đó trên s3.wispace.app. Gửi audio_url cùng question_id và part tương ứng khi chấm. Ví dụ rút gọn: audio_url thật còn nhiều tham số ký nữa.

Lưu ý

question_id và prompt_text trong ví dụ là câu hỏi thật trong danh mục; audio_url được rút gọn.
audio_url là bản ghi câu trả lời mẫu tương ứng và có thể gửi tới grading-json cùng question_id, part và prompt_text. URL được ký, hết hạn sau 15 phút; lấy URL mới khi cần, không lưu để tái sử dụng lâu dài.
Endpoint này không phải là user-scoped: không cần X-User-Identity, và lượt gọi không được báo cáo dưới bất kỳ End-User ID nào.
Endpoint này không yêu cầu X-API-Key và không giới hạn theo API key scope.

curl -X GET 'https://api.aihubproduction.com/v1/ielts/speaking/questions?part=1'

Lỗi thường gặp

Endpoint lấy câu hỏi là public, không cần API key hay User Identity. Theo contract hiện tại, endpoint này khai báo INVALID_REQUEST khi tham số part không hợp lệ và INTERNAL_ERROR khi AIHUB gặp lỗi ngoài dự kiến; không áp dụng các lỗi riêng của API chấm Speaking.

400INVALID_REQUESTPart không hợp lệ

Tham số part chỉ nhận 1, 2 hoặc 3.

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "…",
    "request_id": "req_01M23NT8MJW22AYX6FVT17F5XF",
    "retryable": false
  }
}

500INTERNAL_ERRORLỗi phía AIHUB

Lỗi ngoài dự kiến. Thử lại sau và báo kèm request_id nếu vẫn lỗi.

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "…",
    "request_id": "req_01M23NT8MJW22AYX6FVT17F5XF",
    "retryable": true
  }
}