Gestisci la distribuzione dentro il tuo prodotto
Engine è l’API di Aevora. Crea uscite, consegnale agli store, leggi gli analytics e gestisci le royalty via REST, dal prodotto che i tuoi clienti usano già. La documentazione è pubblica e c’è una sandbox su cui sviluppare.
- Interfaccia
- REST e JSON
- Autenticazione
- Chiavi API, un set per ogni ambiente
- Sandbox
- Consegne di prova, senza store coinvolti
Quattro chiamate portano un’uscita dalla bozza al rendiconto
L’API segue il percorso che un’uscita compie nella dashboard: crearla, consegnarla, leggere i numeri man mano che arrivano e infine leggere il rendiconto. Scegli una chiamata per vedere cosa invii e cosa ricevi.
- Richieste e risposte sono in JSON
- Un errore indica il campo che ha fallito e il motivo
- Le stesse chiamate funzionano in sandbox e in produzione
API Engine
Richieste di esempioPOST/v1/releases
Corpo della richiesta
{ "title": "Night Drive", "artist": "Mira Kaya", "label": "Northfield Audio", "release_date": "2027-03-12"}Risposta
{ "id": "rel_8f2k1", "status": "draft", "upc": null}Ciò che sta attorno agli endpoint
Le chiamate sono la parte breve di un’integrazione. Questi sono gli elementi che la fanno funzionare quando nessuno la controlla.
- Webhook
- Ricevi un evento quando una consegna cambia stato, un’uscita va online o un rendiconto è pronto, così non devi interrogare l’API di continuo.
- Chiavi di idempotenza
- Invia una chiave con una richiesta di scrittura e un nuovo tentativo restituisce il primo risultato invece di creare una seconda uscita.
- Paginazione
- Gli elenchi restituiscono un cursore. Rimandalo indietro per ottenere la pagina successiva, sempre nello stesso ordine.
- Sandbox
- Un ambiente separato con chiavi proprie. Le consegne percorrono tutto il flusso e si fermano prima di qualsiasi store.
- Versionamento
- La versione fa parte del percorso. Una modifica incompatibile esce con una nuova versione, e quella su cui hai sviluppato resta com’è.
- Limiti di frequenza
- Ogni risposta indica quanta parte della tua quota resta, e una richiesta limitata indica quando riprovare.
Dalla prima chiave alla consegna online
- 1
Ottieni le tue chiavi
Richiedi un account. Dopo l'approvazione, crea una chiave sandbox.
- 2
Sviluppa sulla sandbox
Crea uscite ed esegui consegne di prova finché la tua integrazione gestisce ogni stato.
- 3
Richiedi l’accesso alla produzione
Raccontaci cosa stai costruendo. Lo valutiamo e rilasciamo le chiavi di produzione.
- 4
Consegna
Passa alla chiave di produzione e le stesse chiamate raggiungono gli store reali.