Tài liệu tích hợp
Chào mừng bạn đến với hệ thống Neo API. Đây là nền tảng cung cấp các API tiện ích tốc độ cao, ổn định và bảo mật.
Base URL: ...
Xác thực (Authentication)
Một số API yêu cầu API Key để sử dụng. Bạn cần gửi key thông qua Header hoặc Query Parameter.
Cách 1: Sử dụng Header (Khuyên dùng)
GET /api/example
Host: localhost
x-api-key: YOUR_API_KEY_HERE
Cách 2: Sử dụng Query Param
GET /api/example?apikey=YOUR_API_KEY_HERE
Giới hạn Request
Để đảm bảo hiệu năng, chúng tôi áp dụng Rate Limiting cho từng IP:
- Public: 60 requests / phút.
- Spam Protection: Nếu vi phạm quá 5 lần, IP sẽ bị khóa tự động trong 10 phút.
Thông tin giới hạn sẽ được trả về trong Header của response:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 1678900000
Cấu trúc phản hồi lỗi
Mọi phản hồi lỗi sẽ có định dạng JSON chuẩn như sau:
{
"success": false,
"error": {
"code": "RATE_LIMIT",
"message": "Quá nhiều yêu cầu, vui lòng thử lại sau."
}
}