Rulați distribuția din propriul produs
Engine este API-ul Aevora. Creați lansări, livrați-le către platforme, citiți analize și rulați calculul redevențelor prin REST, din produsul pe care clienții dumneavoastră îl folosesc deja. Documentația este publică și aveți un sandbox pentru dezvoltare.
- Interfață
- REST și JSON
- Autentificare
- Chei API, un set pentru fiecare mediu
- Sandbox
- Livrări de test, fără platforme implicate
Patru apeluri duc o lansare de la ciornă la raport
API-ul urmează drumul pe care îl parcurge o lansare în panoul de control: o creați, o livrați, citiți cifrele pe măsură ce sosesc, apoi citiți raportul. Alegeți un apel ca să vedeți ce trimiteți și ce primiți înapoi.
- Cererile și răspunsurile sunt în JSON
- O eroare indică câmpul care a eșuat și motivul
- Aceleași apeluri funcționează în sandbox și în producție
API Engine
Exemple de cereriPOST/v1/releases
Corpul cererii
{ "title": "Night Drive", "artist": "Mira Kaya", "label": "Northfield Audio", "release_date": "2027-03-12"}Răspuns
{ "id": "rel_8f2k1", "status": "draft", "upc": null}Ce se află în jurul endpoint-urilor
Apelurile sunt partea scurtă a unei integrări. Acestea sunt părțile care o țin în funcțiune când nu se uită nimeni la ea.
- Webhook-uri
- Primiți un eveniment când o livrare își schimbă starea, o lansare devine activă sau un raport este gata, ca să nu mai fie nevoie de interogări repetate.
- Chei de idempotență
- Trimiteți o cheie împreună cu o cerere de scriere, iar o reîncercare returnează primul rezultat în loc să creeze o a doua lansare.
- Paginare
- Listele returnează un cursor. Trimiteți-l înapoi pentru a obține pagina următoare, în aceeași ordine de fiecare dată.
- Sandbox
- Un mediu separat, cu propriile chei. Livrările rulează de la început până la sfârșit și se opresc înainte de orice platformă.
- Versionare
- Versiunea face parte din cale. O modificare incompatibilă apare sub o versiune nouă, așa că cea pentru care ați construit rămâne neschimbată.
- Limite de frecvență
- Fiecare răspuns arată cât din cota dumneavoastră a mai rămas, iar o cerere limitată indică când să reîncercați.
De la prima cheie la livrarea reală
- 1
Obțineți cheile
Cereți un cont. După aprobare, creați o cheie sandbox.
- 2
Dezvoltați în sandbox
Creați lansări și rulați livrări de test până când integrarea gestionează toate stările.
- 3
Solicitați acces la producție
Spuneți-ne ce construiți. Verificăm și emitem chei de producție.
- 4
Livrați
Treceți la cheia de producție, iar aceleași apeluri ajung la platforme reale.