Tài liệu API xổ số Việt Nam
Tra cứu kết quả miền Nam (MN), miền Trung (MT), miền Bắc (MB) theo ngày. Ví dụ bên dưới sử dụng endpoint đọc kết quả công khai, không phải endpoint thương mại yêu cầu API key.
1. Endpoint đọc kết quả công khai
GET https://zigpqddlhvjbjrwhfhaa.supabase.co/functions/v1/xoso-public?region=MN&date=2026-10-20| Tham số | Giá trị |
|---|---|
region | MN, MT, MB |
date | YYYY-MM-DD, mặc định ngày hiện tại theo Việt Nam |
Ví dụ phản hồi (rút gọn)
{ "success": true, "region": "MN", "date": "2026-10-20", "source": "...", "count": 3, "data": [{ "province": "...", "prizes": { "db": ["..."], "g1": ["..."] } }] }Trường data là danh sách đài; mỗi đài có province và prizes. Khi chưa có dữ liệu, phản hồi có thể chứa success: false và data: [].
2. Dùng thử ngay
Chọn miền và ngày rồi nhấn Gửi yêu cầu.
3. API key và giới hạn sử dụng
Đăng ký / đăng nhập để vào Dashboard. Tại đây bạn có thể xem API key, gói hiện tại, hạn sử dụng, tổng số request và số request trong ngày theo quyền tài khoản.
| Gói | Giới hạn trong hệ thống |
|---|---|
| Dùng thử | 500 request/ngày; 30 request/phút |
| Cơ bản | 2.000 request/ngày; 60 request/phút |
| Nâng cao | 5.000 request/ngày; 120 request/phút |
| Pro | 10.000 request/ngày; 300 request/phút |
Lưu ý: API key và hạn mức tài khoản đã có trong Dashboard, nhưng endpoint thương mại xác thực API key chưa được xác nhận hoạt động đầu-cuối. Không nên coi endpoint công khai phía trên là dịch vụ API key có bảo đảm hạn mức hoặc SLA.
4. Thanh toán và gia hạn
Xem bảng giá và QR chuyển khoản. Sau khi chuyển khoản, gửi yêu cầu nâng cấp. Quản trị viên xác nhận thanh toán và kích hoạt/gia hạn thủ công; không tự động mở quyền chỉ vì người dùng nhấn nút đã thanh toán.
Trước khi kinh doanh API trả phí, cần xác minh quyền phân phối thương mại đối với dữ liệu nguồn.