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êtesPOST/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
Obtenez vos clés
Faites une demande de compte. Une fois approuvé, créez une clé sandbox.
- 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
Demandez l’accès à la production
Dites-nous ce que vous construisez. Nous l’examinons et émettons vos clés de production.
- 4
Livrer
Passez à la clé de production et les mêmes appels atteignent de vraies plateformes.