Kør distribution fra dit eget produkt

Engine er Aevora' API. Opret udgivelser, lever dem til butikker, læs analyser og kør royaltyberegninger via REST, fra det produkt, dine kunder allerede bruger. Dokumentationen er offentlig, og der er en sandbox at bygge mod.

Grænseflade
REST og JSON
Autentificering
API-nøgler, ét sæt pr. miljø
Sandbox
Testleveringer, ingen butikker involveret

Fire kald fører en udgivelse fra kladde til opgørelse

API'et følger den vej, en udgivelse tager i dashboardet: opret den, lever den, læs tallene, efterhånden som de kommer ind, og læs derefter opgørelsen. Vælg et kald for at se, hvad du sender, og hvad du får tilbage.

  • Forespørgsler og svar er JSON
  • En fejl angiver, hvilket felt der fejlede, og hvorfor
  • De samme kald virker i sandboxen og i produktion

Engine API

Eksempler på forespørgsler

POST/v1/releases

Forespørgselsindhold

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

Svar

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

Det, der omgiver endpoints

Kaldene er den korte del af en integration. Det her er de dele, der holder den kørende, når ingen holder øje.

Webhooks
Modtag en hændelse, når en levering skifter status, en udgivelse går live, eller en opgørelse er klar, så du slipper for at polle.
Idempotensnøgler
Send en nøgle med en skriveforespørgsel, og et nyt forsøg returnerer det første resultat i stedet for at oprette en anden udgivelse.
Paginering
Lister returnerer en markør. Send den tilbage for at få næste side, altid i samme rækkefølge.
Sandbox
Et separat miljø med egne nøgler. Leveringer kører fra start til slut og stopper, før de når en butik.
Versionering
Versionen er en del af stien. En ændring, der bryder kompatibiliteten, udgives under en ny version, så den, du har bygget mod, forbliver uændret.
Rate limits
Hvert svar fortæller, hvor meget af din kvote der er tilbage, og en begrænset forespørgsel fortæller, hvornår du kan prøve igen.

Fra første nøgle til live levering

  1. 1

    Få dine nøgler

    Ansøg om en konto. Når den er godkendt, opretter du en sandbox-nøgle.

  2. 2

    Byg mod sandboxen

    Opret udgivelser og kør testleveringer, indtil din integration håndterer alle statusser.

  3. 3

    Anmod om produktionsadgang

    Fortæl os, hvad du bygger. Vi gennemgår det og udsteder produktionsnøgler.

  4. 4

    Lever

    Skift til produktionsnøglen, så når de samme kald rigtige butikker.

Spørgsmål om Engine

Nej. Referencen er offentlig. Du har først brug for en konto, som vi opretter efter ansøgning, når du vil have en nøgle.

Ja. En udgivelse oprettet via API'et vises i dashboardet, og en udgivelse oprettet i dashboardet kan læses og leveres via API'et.

Leveringen går gennem de samme statusser som en rigtig og sender de samme webhooks, men intet sendes til en butik.

Send din første forespørgsel i sandboxen