Error Codes#
HTTP Status Codes#
| Code | Mô tả | Xử lý |
|---|---|---|
200 | Thành công | — |
201 | Tạo thành công | — |
400 | Request không hợp lệ | Kiểm tra body |
401 | API Key không hợp lệ | Kiểm tra X-API-Key |
403 | Không có quyền | Task không thuộc server |
404 | Không tìm thấy | Task không tồn tại |
500 | Lỗi hệ thống | Retry sau 5-10s |
Response format#
Thành công:
{"success": true, "data": { ... }}Lỗi:
{"success": false, "message": "Mô tả lỗi"}Lỗi thường gặp#
| Error | Nguyên nhân |
|---|---|
API key required | Thiếu header X-API-Key |
Invalid API key | Key sai hoặc server đã xóa |
Server is not active | Server offline, cần gửi heartbeat |
not_your_task | Task gán cho server khác |
Link not found | Task không tồn tại |