Tài liệu
Hướng dẫn
Bắt đầu nhanh, xác thực, request, lỗi, giới hạn, phân trang, webhook và phân phối DDEX.
- Bắt đầu nhanh Tạo API key trong ứng dụng web HILLS, kiểm tra bằng /me, rồi liệt kê bản phát hành và đọc doanh thu của bạn. Chỉ mất khoảng năm phút.
- Xác thực Gửi API key hm_live_ dưới dạng Bearer token. Cách tạo key, chọn scope, đặt thời hạn, xoay vòng và thu hồi key, và ý nghĩa của từng lỗi xác thực.
- Gửi request Base URL, định dạng JSON của request và phản hồi, các header phản hồi, phiên bản và ngừng hỗ trợ, và những gì cần gửi bộ phận hỗ trợ khi có sự cố.
- Lỗi Định dạng lỗi, mọi mã trạng thái và code mà API trả về, lỗi nào nên thử lại, và một hàm xử lý lỗi Node bạn có thể sao chép ngay.
- Rate limit Số request mỗi phút cho mỗi API key theo từng gói, các header X-RateLimit, phản hồi 429 trông thế nào, cách backoff và giữ dưới giới hạn.
- Phân trang Duyệt bản phát hành theo trang với cursor và next_cursor, duyệt các lần gửi webhook với before và has_more, và chỉ đồng bộ phần đã thay đổi.
- Webhook Nhận sự kiện HILLS Music tại endpoint HTTPS của bạn: đăng ký, 13 loại sự kiện, envelope, xác minh X-Hills-Signature, cơ chế gửi lại và nhật ký.
- Phân phối DDEX Gửi bản phát hành dạng DDEX ERN: kiểm thử lô với POST /ddex/validate, phân phối bằng POST /ddex hoặc tải lên trực tiếp, dùng SFTP và đọc báo cáo phân phối.