REST API · v1

Tài liệu API XuniBOX

API chỉ đọc để lấy danh sách nhạc, nghệ sĩ và thể loại từ kho XuniBOX. Mỗi chủ đề dưới đây là một trang riêng, có đường dẫn riêng để bạn chia sẻ cho đội kỹ thuật.

Bắt đầu nhanh Xem endpoints Tra cứu yêu cầu

Xác thực bằng API key

Gửi khóa trong header X-API-Key. Không đặt trong query string, không nhúng vào bundle frontend, không commit vào repo. Key có tiền tố xnb_live_ và chỉ hiện đầy đủ đúng một lần lúc admin cấp.

HTTP header

GET /api/public/tracks HTTP/1.1
Host: xunibox.vn
Accept: application/json
X-API-Key: xnb_live_your_key

Gọi từ backend, đừng gọi từ trình duyệt. API bật CORS * nên trình duyệt gọi được, nhưng lúc đó key nằm trong tab Network của mọi người dùng. Cách đúng: frontend của bạn gọi backend của bạn, backend gắn key rồi gọi XuniBOX.

Giới hạn tần suất

Mỗi key có hạn mức request/phút do admin đặt (mặc định 60). Khi chạm trần bạn nhận 429 kèm Retry-After tính bằng giây.

Header	Ý nghĩa
X-RateLimit-Limit	Số request tối đa trong cửa sổ hiện tại.
X-RateLimit-Remaining	Số request còn lại.
X-RateLimit-Reset	Unix timestamp khi hạn mức reset.
Retry-After	Số giây nên chờ trước khi thử lại (chỉ có ở 429).

Cần hạn mức cao hơn cho đợt import ban đầu? Nhắn qua form xin quyền tích hợp, ghi rõ số bài dự kiến đồng bộ.

Tổng quan Bắt đầu nhanh

Sẵn sàng tích hợp?

Gửi thông tin sản phẩm để admin XuniBOX xét duyệt và cấp API key.

Xin quyền tích hợp