API Playground

Chọn endpoint, điền tham số và gọi thử ngay trên trình duyệt. Toàn bộ kho nhạc, tìm kiếm, xu hướng, giấy phép, nghệ sĩ và thể loại đều là API công khai — không cần API key. Ô X-API-Key bên dưới là tùy chọn, chỉ dùng cho 3 endpoint dành riêng cho đối tác: báo cáo mức sử dụng (/me/usage), quản lý webhook (/webhooks) và nghe thử có watermark (/tracks/{id}/watermarked). Key chỉ lưu trên máy bạn (localStorage), không gửi về máy chủ XuniBOX ngoài header X-API-Key.

Phiên bản API

Máy chủ gọi thử

Endpoint

X-API-Key (tùy chọn)(bắt buộc cho endpoint này)

Endpoint quản lý webhook (POST/DELETE /webhooks) và nghe thử có watermark (/tracks/{id}/watermarked) cần API key và được tài liệu hóa riêng tại /developers/webhooks.

Tham số

qTìm trong title, artist, genre.

titleTìm một phần tên bài hát.

artistTìm một phần tên nghệ sĩ.

genreTìm một phần thể loại.

artist_idLọc chính xác theo UUID nghệ sĩ.

bpm_minNhịp độ tối thiểu, 0–300.

bpm_maxNhịp độ tối đa, 0–300.

energy_minĐộ sôi động tối thiểu, 0–1.

energy_maxĐộ sôi động tối đa, 0–1.

keyTông nhạc, ví dụ "C major" hoặc "A minor".

licenseMã giấy phép.

commercialtrue để chỉ lấy bài cho phép dùng thương mại.

explicitfalse để loại bài có nội dung người lớn.

sortThứ tự sắp xếp.

pageTrang, 1–5000.

limitSố bản ghi mỗi trang, 1–100.

Request

GET /api/public/tracks

X-API-Key: chưa có — sẽ nhận 401 · spec v1 (1.0.0)

Response

Chưa có kết quả. Bấm “Gửi request” để gọi thử endpoint.

cURL tương đương

curl --request GET \
  --url 'https://xunibox.vn/api/public/tracks' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: xnb_live_your_key'