https://test-api-ielts-writing.aihubproduction.com/create-longwriting-exerciseSinh một bài viết đoạn thân bài 50–100 từ khắc phục đồng thời nhiều lỗi thuộc các tiêu chí khác nhau.
| Field | Type | Bắt buộc | Mô tả |
|---|---|---|---|
| topic | string | BẮT BUỘC | Ví dụ: AI, Education |
| writing_task | 1 | 2 | BẮT BUỘC | Loại Task IELTS Writing |
| errors | array | BẮT BUỘC | Danh sách mẫu lỗi cần khắc phục đồng thời, mỗi phần tử gồm error_no, criterion, error_code, references[] |
Một đoạn văn thân bài (50–100 từ) khắc phục đồng thời các lỗi đã liệt kê, luôn cần AI chấm điểm.
curl -X POST 'https://test-api-ielts-writing.aihubproduction.com/create-longwriting-exercise' \
-H 'Content-Type: application/json' \
-d '{
"topic": "AI, Education",
"writing_task": 2,
"errors": [
{
"error_no": 1,
"criterion": "task_response",
"error_code": "unclear_stance",
"references": []
}
]
}'Áp dụng chung cho các endpoint sinh bài tập trong docs/doc-api-micro.md.
AI sinh lỗi định dạng hoặc vi phạm schema validation. Hệ thống không trả 500 mà trả 200 kèm exercise rỗng.
{
"success": true,
"message": "Lỗi parse JSON hoặc validate từ AI. Trả về kết quả mặc định rỗng.",
"data": {
"meta": {
"number_of_questions": 0
},
"exercise": []
}
}Thiếu trường bắt buộc, sai kiểu dữ liệu, hoặc error_code không hợp lệ cho task/criterion.
{
"detail": [
{
"loc": [
"body",
"criterion"
],
"msg": "Value error, Invalid criterion for task 1",
"type": "value_error"
}
]
}DB chưa có đủ bài làm thật khớp điều kiện lọc.
{
"error": "Not enough references found",
"available": 1,
"requested": 3
}Lỗi hệ thống không lường trước, nạp API key LLM thất bại, hoặc mất kết nối mạng.
{
"detail": "Failed to load LLM"
}