Aller au contenu
API HILLS v1 Accès anticipé

Référence API

Statuts

Statuts possibles d’une sortie et de chacune de ses plateformes, tels que renvoyés par l’API. status garde l’ancien terme pendant un cycle d’obsolescence.

L’approbation déclenche la livraison immédiatement ; une plateforme apparaît en ligne dès que la sortie l’est.

release_status

Code Signification
draft Brouillon : pas encore soumise.
in_review En vérification : soumise, en attente d’une décision.
changes_requested Modifications demandées : renvoyée à l’artiste avec un motif ; de nouveau modifiable.
approved Approuvée : aussitôt livrée à ses plateformes.
archived Archivée : non livrée.
taken_down Retirée : retirée de toutes les plateformes où elle était présente.

delivery_state

Code Signification
not_started Pas commencée : aucune plateforme n’a encore rien reçu.
delivering Livraison en cours : la sortie est en cours d’envoi à ses plateformes.
delivered Livrée : toutes les plateformes l’ont reçue ; aucune ne l’affiche encore en ligne.
partially_live En ligne sur une partie des plateformes : en ligne sur certaines ; les autres l’ont reçue ou sont en train de la recevoir.
live En ligne : en ligne sur toutes les plateformes où elle a été envoyée.
needs_attention Action requise : une plateforme a échoué, l’a refusée ou attend une intervention humaine (sa page indique qui doit agir).
taking_down Retrait en cours : un retrait est en cours d’envoi à ses plateformes.
taken_down Retirée : retirée de toutes les plateformes où elle était présente.

update_state

Code Signification
none Toutes les plateformes ont la dernière version approuvée.
pending Une version approuvée plus récente attend d’être envoyée.
delivering Une version approuvée plus récente est en cours d’envoi.

stores[key].status

Code Signification
awaiting_approval En attente d’approbation (phase review)
queued En cours d’envoi (phase queue)
delivered Livrée (phase done)
live En ligne (phase done)
failed Correction requise de votre part (phase attention)
takedown_queued Retrait demandé (phase takedown)
taken_down Retirée (phase takedown)

status (obsolète, supprimé le 30 avril 2027)

Code Signification
draft release_status draft
pending release_status in_review
approved release_status approved, encore en ligne sur aucune plateforme
distributed release_status approved, en ligne sur au moins une plateforme
rejected release_status changes_requested
archived release_status archived ou taken_down

Prêt à vous intégrer ?

Demandez l’accès à l’API : nous vous répondons sous 1–3 business days.