Documentation
Guides
Démarrage rapide, authentification, requêtes, erreurs, limites, pagination, webhooks et livraison DDEX.
- Démarrage rapide Créez une clé d’API dans l’application web HILLS, vérifiez-la avec /me, puis listez vos sorties et consultez vos revenus. Environ cinq minutes.
- Authentification Envoyez votre clé d’API hm_live_ comme jeton Bearer : création, scopes, expiration, renouvellement, révocation et erreurs d’authentification.
- Faire des requêtes URL de base, format JSON des requêtes et des réponses, en-têtes de réponse, versions et obsolescences, et quoi transmettre au support en cas de problème.
- Erreurs Le format des erreurs, tous les statuts et codes renvoyés par l’API, les erreurs à retenter, et un gestionnaire d’erreurs Node prêt à copier.
- Limites de débit Requêtes par minute et par clé d’API selon l’offre, les en-têtes X-RateLimit, la forme d’une 429, et comment ralentir pour rester sous la limite.
- Pagination Parcourez les sorties avec cursor et next_cursor, les livraisons de webhooks avec before et has_more, et ne synchronisez que ce qui a changé.
- Webhooks Recevez les événements HILLS Music sur votre endpoint HTTPS : abonnement, 13 types d’événements, enveloppe, signature, relances et journal.
- Livraison DDEX Livrez en DDEX ERN : testez un lot avec POST /ddex/validate, livrez avec POST /ddex ou l’envoi direct, passez par le SFTP et lisez le rapport.