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ørgslerPOST/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
Få dine nøgler
Ansøg om en konto. Når den er godkendt, opretter du en sandbox-nøgle.
- 2
Byg mod sandboxen
Opret udgivelser og kør testleveringer, indtil din integration håndterer alle statusser.
- 3
Anmod om produktionsadgang
Fortæl os, hvad du bygger. Vi gennemgår det og udsteder produktionsnøgler.
- 4
Lever
Skift til produktionsnøglen, så når de samme kald rigtige butikker.