XOSOAPI v2.1

Tài liệu API xổ số

Tra kết quả MN / MT / MB theo ngày, dùng cache Supabase, API key và giới hạn 60 request/phút.

API đang hoạt động

Tổng quan

Region	Khu vực
MN	Miền Nam
MT	Miền Trung
MB	Miền Bắc

Luồng: kiểm tra cache → có thì trả ngay → chưa có thì lấy nguồn → parse → lưu Supabase → trả JSON.

Endpoint

https://zigpqddlhvjbjrwhfhaa.supabase.co/functions/v1/xosoapi

Tham số

Tên	Bắt buộc	Ví dụ	Mô tả
`region`	Có	MN	MN, MT hoặc MB
`date`	Có	2026-10-01	Định dạng YYYY-MM-DD
`key`	Có	YOUR_API_KEY	API key hợp lệ

Ví dụ gọi API

MN
https://zigpqddlhvjbjrwhfhaa.supabase.co/functions/v1/xosoapi?region=MN&date=2026-10-01&key=YOUR_API_KEY

MT
https://zigpqddlhvjbjrwhfhaa.supabase.co/functions/v1/xosoapi?region=MT&date=2026-10-01&key=YOUR_API_KEY

MB
https://zigpqddlhvjbjrwhfhaa.supabase.co/functions/v1/xosoapi?region=MB&date=2026-10-01&key=YOUR_API_KEY

Response mẫu

{
  "success": true,
  "api": "xosoapi",
  "version": "2.1",
  "region": "MN",
  "date": "2026-10-01",
  "source": "xsmn.mobi",
  "cached": true,
  "count": 3,
  "data": [...]
}

Mã lỗi

HTTP	Ý nghĩa
200	Thành công
400	Thiếu hoặc sai tham số
401	API key không hợp lệ
429	Vượt quá 60 request/phút
500	Lỗi xử lý phía server

Cache & bảo vệ API

Dữ liệu đã có trong Supabase sẽ được trả từ cache để giảm thời gian phản hồi và giảm số lần gọi nguồn ngoài.

API yêu cầu key hợp lệ và có giới hạn 60 request/phút cho mỗi key.

Mở trang Test API