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 esempio

POST/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. 1

    Ottieni le tue chiavi

    Richiedi un account. Dopo l'approvazione, crea una chiave sandbox.

  2. 2

    Sviluppa sulla sandbox

    Crea uscite ed esegui consegne di prova finché la tua integrazione gestisce ogni stato.

  3. 3

    Richiedi l’accesso alla produzione

    Raccontaci cosa stai costruendo. Lo valutiamo e rilasciamo le chiavi di produzione.

  4. 4

    Consegna

    Passa alla chiave di produzione e le stesse chiamate raggiungono gli store reali.

Domande su Engine

No. La documentazione è pubblica. Ti serve un account, che apriamo su richiesta, solo quando vuoi una chiave.

Sì. Un’uscita creata via API compare nella dashboard, e una creata nella dashboard può essere letta e consegnata via API.

La consegna attraversa gli stessi stati di una reale e invia gli stessi webhook, ma non viene inviato nulla a nessuno store.

Fai la tua prima richiesta in sandbox