Driv distribution från din egen produkt

Engine är Aevora API. Skapa releaser, leverera dem till butiker, läs analys och kör royaltyberäkningar via REST, från den produkt som dina kunder redan använder. Dokumentationen är offentlig och det finns en sandbox att bygga mot.

Gränssnitt
REST och JSON
Autentisering
API-nycklar, en uppsättning per miljö
Sandlåda
Testleveranser, inga butiker inblandade

Fyra anrop tar en release från utkast till redovisning

API:et följer den väg en release tar i kontrollpanelen: skapa den, leverera den, läs siffrorna när de kommer in och läs sedan redovisningen. Välj ett anrop för att se vad du skickar och vad du får tillbaka.

  • Förfrågningar och svar är JSON
  • Ett fel anger vilket fält som misslyckades och varför
  • Samma anrop fungerar i sandboxen och i produktion

Engine API

Exempelanrop

POST/v1/releases

Anropets innehåll

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

Svar

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

Vad som finns runt endpoints

Anropen är den korta delen av en integration. Det här är de delar som håller den igång när ingen tittar.

Webhooks
Ta emot en händelse när en leverans byter status, en release går live eller en redovisning är klar, så att du slipper polla.
Idempotensnycklar
Skicka en nyckel med en skrivförfrågan, så ger ett nytt försök det första resultatet i stället för att skapa en andra release.
Paginering
Listor returnerar en markör. Skicka tillbaka den för att få nästa sida, alltid i samma ordning.
Sandlåda
En separat miljö med egna nycklar. Leveranser körs från början till slut och stannar innan någon butik.
Versionshantering
Versionen är en del av sökvägen. En ändring som bryter kompatibiliteten släpps under en ny version, så den du byggde mot förblir oförändrad.
Hastighetsbegränsningar
Varje svar talar om hur mycket av din kvot som är kvar, och en begränsad förfrågan talar om när du kan försöka igen.

Från första nyckeln till live-leverans

  1. 1

    Skaffa dina nycklar

    Ansök om ett konto. När det har godkänts skapar du en sandbox-nyckel.

  2. 2

    Bygg mot sandboxen

    Skapa releaser och kör testleveranser tills din integration hanterar varje status.

  3. 3

    Begär produktionsåtkomst

    Berätta vad du bygger. Vi granskar det och utfärdar produktionsnycklar.

  4. 4

    Leverera

    Byt till produktionsnyckeln så når samma anrop riktiga butiker.

Frågor om Engine

Nej. Referensen är offentlig. Du behöver ett konto, som vi öppnar efter ansökan, först när du vill ha en nyckel.

Ja. En release som skapats via API:et visas i kontrollpanelen, och en release som skapats i kontrollpanelen kan läsas och levereras via API:et.

Leveransen går igenom samma statusar som en riktig och skickar samma webhooks, men ingenting skickas till någon butik.

Gör din första förfrågan i sandboxen