XuniBOX
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 nhanhXem endpointsTra cứu yêu cầu

Bắt đầu nhanh

  1. 1. Gửi form xin API key, admin duyệt và cấp key.
  2. 2. Lưu key vào biến môi trường phía server, ví dụ XUNIBOX_API_KEY.
  3. 3. Gọi thử GET /tracks?limit=1 để chắc chắn key hoạt động.
  4. 4. Ghép vào bộ chọn nhạc của bạn.

Ví dụ dưới lấy 20 bài Pop của Minh Anh có chứa từ khóa “summer”, sắp theo lượt phát:

JavaScript · Fetch API
const response = await fetch(
  "https://xunibox.vn/api/public/tracks?genre=Pop&artist=Minh%20Anh&q=summer&sort=popular&page=1&limit=20",
  {
    headers: {
      "X-API-Key": process.env.XUNIBOX_API_KEY,
      "Accept": "application/json"
    }
  }
);

if (!response.ok) {
  throw new Error(`XuniBOX API error: ${response.status}`);
}

const { data: tracks, meta } = await response.json();
console.log(meta.total, meta.page, meta.limit);
cURL
curl --request GET \
  --url 'https://xunibox.vn/api/public/tracks?sort=newest&page=1&limit=20' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: xnb_live_your_key'
Xác thựcQuy ước chung

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