Documentation
Bắt đầu trong 5 phút
Sau khi admin gửi key về tài khoản, bạn dùng key đó gọi API qua header Authorization.
1 · Xác thực
Mọi request cần kèm API key của bạn trong header:
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx
2 · Endpoints chính
| Method | Endpoint | Mô tả |
|---|---|---|
| GET | /v2/sports | Danh sách môn thể thao được hỗ trợ |
| GET | /v2/leagues | Danh sách giải đấu (lọc theo sport) |
| GET | /v2/events | Danh sách trận đấu + odds (lọc theo ngày/giải) |
| GET | /v2/events/{id}/odds | Toàn bộ odds của 1 trận, theo bookmaker |
| GET | /v2/scores | Live scores, trạng thái trận |
| GET | /account/usage | Kiểm tra hạn mức & mức dùng của key |
# Ví dụ: lấy events NBA hôm nay có odds
curl "https://api.example.com/v2/events?leagueID=NBA&oddsAvailable=true&limit=20" \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx"
curl "https://api.example.com/v2/events?leagueID=NBA&oddsAvailable=true&limit=20" \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx"
3 · Giới hạn & lỗi
- Rate limit tính theo phút, tùy gói (xem bảng Pricing). Vượt limit trả về 429 kèm header Retry-After.
- Key không hợp lệ → 401 Unauthorized. Hết hạn mức → 403.
- Key thuê theo tháng sẽ tự báo hết hạn trước 3 ngày — gia hạn trong Dashboard để giữ nguyên key.
4 · Quản lý key
Toàn bộ key đã thuê nằm trong Dashboard → My API Keys. Khi admin gửi key, bạn sẽ thấy key xuất hiện ngay tại đó.