Kjør distribusjon fra ditt eget produkt

Engine er Aevora-API-et. Opprett utgivelser, lever dem til butikker, les analyser og kjør royaltyoppgjør over REST, fra produktet kundene dine allerede bruker. Dokumentasjonen er offentlig, og det finnes en sandkasse å bygge mot.

Grensesnitt
REST og JSON
Autentisering
API-nøkler, ett sett per miljø
Sandkasse
Testleveringer, uten at butikker er involvert

Fire kall tar en utgivelse fra utkast til oppgjør

API-et følger veien en utgivelse tar i dashbordet: opprett den, lever den, les tallene etter hvert som de kommer, og les deretter oppgjøret. Velg et kall for å se hva du sender og hva du får tilbake.

  • Forespørsler og svar er JSON
  • En feil oppgir feltet som feilet og hvorfor
  • De samme kallene fungerer i sandkassen og i produksjon

Engine API

Eksempelforespørsler

POST/v1/releases

Forespørselens innhold

{  "title": "Night Drive",  "artist": "Mira Kaya",  "label": "Northfield Audio",  "release_date": "2027-03-12"}

Svar

{  "id": "rel_8f2k1",  "status": "draft",  "upc": null}

Det som ligger rundt endepunktene

Kallene er den korte delen av en integrasjon. Dette er det som holder den i gang når ingen følger med.

Webhooks
Motta en hendelse når en levering endrer status, en utgivelse går live eller et oppgjør er klart, slik at du slipper å polle.
Idempotensnøkler
Send en nøkkel med en skriveforespørsel, så returnerer et nytt forsøk det første resultatet i stedet for å opprette en ny utgivelse.
Paginering
Lister returnerer en markør. Send den tilbake for å hente neste side, i samme rekkefølge hver gang.
Sandkasse
Et eget miljø med egne nøkler. Leveringer kjører fra start til slutt og stopper før de når noen butikk.
Versjonering
Versjonen er en del av stien. En endring som bryter kompatibiliteten kommer under en ny versjon, slik at den du bygde mot forblir som den er.
Ratebegrensninger
Hvert svar forteller hvor mye av kvoten din som er igjen, og en begrenset forespørsel forteller når du kan prøve igjen.

Fra første nøkkel til live levering

  1. 1

    Hent nøklene dine

    Søk om en konto. Når den er godkjent, oppretter du en sandkassenøkkel.

  2. 2

    Bygg mot sandkassen

    Opprett utgivelser og kjør testleveringer til integrasjonen din håndterer alle statuser.

  3. 3

    Be om produksjonstilgang

    Fortell oss hva du bygger. Vi gjennomgår det og utsteder produksjonsnøkler.

  4. 4

    Lever

    Bytt til produksjonsnøkkelen, så når de samme kallene ekte butikker.

Spørsmål om Engine

Nei. Referansen er offentlig. Du trenger en konto, som vi oppretter etter søknad, først når du vil ha en nøkkel.

Ja. En utgivelse opprettet via API-et vises i dashbordet, og en utgivelse opprettet i dashbordet kan leses og leveres via API-et.

Leveringen går gjennom de samme statusene som en ekte, og sender de samme webhookene, men ingenting sendes til en butikk.

Send din første forespørsel i sandkassen