API sportsbook Nocturn Sport cho đội kỹ thuật
API của Nocturn Sport cho phép nhà điều hành tự xây frontend mà vẫn dùng tỷ lệ, cơ chế đặt cược và quản trị rủi ro của chúng tôi.
Cập nhật 5 tháng 10, 2026
API sportsbook của Nocturn Sport dành cho các nhà điều hành đã có frontend hoặc muốn kiểm soát hoàn toàn trải nghiệm người chơi. API gồm bốn nhóm chức năng: nhận feed tỷ lệ trước trận, đặt cược, tra cứu lịch sử cược và đồng bộ số dư người chơi. Mọi giá trong feed đều do mô hình nội bộ của chúng tôi tính.
Feed tỷ lệ: snapshot rồi delta theo phiên bản
Lần đầu kết nối, hệ thống của bạn nhận một snapshot đầy đủ: môn thể thao, giải đấu, sự kiện, cửa cược và lựa chọn kèm giá hiện tại. Mỗi phản hồi mang một số phiên bản. Sau đó, client hỏi lại theo chu kỳ khoảng 10 giây, gửi kèm phiên bản cuối cùng đã có, và chỉ nhận về các thay đổi (delta) kể từ phiên bản đó: giá mới, cửa bị treo, sự kiện mới hoặc đã đóng. Cách làm này giữ lưu lượng nhỏ và giúp bạn tái dựng trạng thái chính xác nếu mất kết nối. Cấu trúc dữ liệu được mô tả ở trang feed tỷ lệ.
Đặt cược với request ID
API hỗ trợ cược đơn và cược xiên. Mỗi yêu cầu đặt cược mang một request ID duy nhất do bạn tạo; nếu mạng chập chờn và bạn gửi lại, hệ thống nhận ra yêu cầu trùng và không tạo vé thứ hai. Khi đặt cược, giá và trạng thái cửa được kiểm tra lại, cùng các ngưỡng bạn đã thiết lập: mức đặt lớn nhất, khoản thắng lớn nhất của vé, số trận được ghép, khung giá cho phép và số phút khóa kèo trước giờ đấu.
Lịch sử cược và số dư
- Lịch sử cược: tra cứu vé theo người chơi, trạng thái (đang chờ, thắng, thua, hoàn tiền) và thời gian.
- Số dư người chơi: đồng bộ số dư giữa ví của bạn và sportsbook khi đặt cược và khi vé được thanh toán.
Back office đi kèm API
Dù dùng API, bạn vẫn có toàn bộ công cụ quản trị: treo một sự kiện, ghi đè giá, nhập kết quả để thanh toán vé, xem mức rủi ro theo sự kiện và đặt biên lợi nhuận. Nếu muốn khởi động nhanh hơn, có thể dùng giao diện white label thay vì tự xây. Tổng quan sản phẩm ở phần mềm sportsbook.
Tích hợp và liên hệ
API cũng có thể được kết nối thông qua SoftAggregator, nếu bạn muốn nhận cả game casino và sportsbook qua một lần tích hợp. Tài liệu kỹ thuật và báo giá được gửi theo yêu cầu: đội kỹ thuật của bạn có thể gửi email về [email protected] hoặc trao đổi trực tiếp với chúng tôi trên Telegram @mentionso; các kênh khác có ở trang liên hệ.
Câu hỏi thường gặp
Bao lâu thì client nên hỏi feed một lần?
Khoảng mỗi 10 giây, gửi kèm số phiên bản cuối cùng đã nhận để chỉ lấy phần thay đổi.
Nếu tôi mất phiên bản cuối thì sao?
Bạn có thể tải lại một snapshot đầy đủ rồi tiếp tục nhận delta từ phiên bản mới.
Request ID dùng để làm gì?
Để chống tạo vé trùng: một yêu cầu đặt cược gửi lại với cùng request ID sẽ không sinh thêm vé mới.
Giá API sportsbook được tính thế nào?
Báo giá theo yêu cầu, tùy quy mô và hình thức tích hợp. Chúng tôi không công bố bảng giá cố định.