Pilotez la distribution depuis votre propre produit

Engine est l’API d’Aevora. Créez des sorties, livrez-les aux plateformes, consultez les statistiques et gérez les redevances via REST, depuis le produit que vos clients utilisent déjà. La documentation est publique et une sandbox est disponible pour développer.

Interface
REST et JSON
Authentification
Clés d’API, un jeu par environnement
Sandbox
Livraisons de test, sans aucune plateforme

Quatre appels mènent une sortie du brouillon au relevé

L’API suit le parcours d’une sortie dans le tableau de bord : on la crée, on la livre, on lit les chiffres à mesure qu’ils arrivent, puis on lit le relevé. Choisissez un appel pour voir ce que vous envoyez et ce que vous recevez.

  • Les requêtes et les réponses sont en JSON
  • Une erreur indique le champ en cause et la raison
  • Les mêmes appels fonctionnent en sandbox et en production

API Engine

Exemples de requêtes

POST/v1/releases

Corps de la requête

{  "title": "Night Drive",  "artist": "Mira Kaya",  "label": "Northfield Audio",  "release_date": "2027-03-12"}

Réponse

{  "id": "rel_8f2k1",  "status": "draft",  "upc": null}

Ce qui entoure les endpoints

Les appels ne sont que la partie courte d’une intégration. Voici ce qui la maintient en état de marche quand personne ne la surveille.

Webhooks
Recevez un événement lorsqu’une livraison change d’état, qu’une sortie passe en ligne ou qu’un relevé est prêt, sans avoir à interroger l’API en boucle.
Clés d’idempotence
Envoyez une clé avec une requête d’écriture : une nouvelle tentative renvoie le premier résultat au lieu de créer une seconde sortie.
Pagination
Les listes renvoient un curseur. Renvoyez-le pour obtenir la page suivante, toujours dans le même ordre.
Sandbox
Un environnement séparé avec ses propres clés. Les livraisons s’exécutent de bout en bout et s’arrêtent avant toute plateforme.
Gestion des versions
La version fait partie du chemin. Un changement non rétrocompatible sort sous une nouvelle version, si bien que celle sur laquelle vous avez développé reste inchangée.
Limites de débit
Chaque réponse indique ce qu’il vous reste de votre quota, et une requête limitée vous dit quand réessayer.

De la première clé à la livraison en production

  1. 1

    Obtenez vos clés

    Faites une demande de compte. Une fois approuvé, créez une clé sandbox.

  2. 2

    Développez sur la sandbox

    Créez des sorties et lancez des livraisons de test jusqu’à ce que votre intégration gère tous les états.

  3. 3

    Demandez l’accès à la production

    Dites-nous ce que vous construisez. Nous l’examinons et émettons vos clés de production.

  4. 4

    Livrer

    Passez à la clé de production et les mêmes appels atteignent de vraies plateformes.

Questions sur Engine

Non. La référence est publique. Vous n’avez besoin d’un compte, que nous ouvrons sur demande, que lorsque vous voulez une clé.

Oui. Une sortie créée via l’API apparaît dans le tableau de bord, et une sortie créée dans le tableau de bord peut être lue et livrée via l’API.

La livraison passe par les mêmes états qu’une livraison réelle et envoie les mêmes webhooks, mais rien n’est envoyé à une plateforme.

Faites votre première requête en sandbox