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 cereri

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

    Obțineți cheile

    Cereți un cont. După aprobare, creați o cheie sandbox.

  2. 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. 3

    Solicitați acces la producție

    Spuneți-ne ce construiți. Verificăm și emitem chei de producție.

  4. 4

    Livrați

    Treceți la cheia de producție, iar aceleași apeluri ajung la platforme reale.

Întrebări despre Engine

Nu. Referința este publică. Aveți nevoie de un cont, pe care îl deschidem pe bază de cerere, doar când doriți o cheie.

Da. O lansare creată prin API apare în panoul de control, iar una creată în panoul de control poate fi citită și livrată prin API.

Livrarea trece prin aceleași stări ca una reală și trimite aceleași webhook-uri, dar nu se trimite nimic către vreo platformă.

Faceți prima cerere în sandbox