Draai distributie vanuit uw eigen product

Engine is de Aevora API. Maak releases aan, lever ze aan stores, lees analyses en draai royalty's via REST, vanuit het product dat uw klanten al gebruiken. De documentatie is openbaar en er is een sandbox om tegen te bouwen.

Interface
REST en JSON
Authenticatie
API-sleutels, één set per omgeving
Sandbox
Testleveringen, zonder stores

Vier aanroepen brengen een release van concept tot afrekening

De API volgt het pad dat een release in het dashboard aflegt: aanmaken, leveren, de cijfers lezen zodra ze binnenkomen en dan de afrekening lezen. Kies een aanroep om te zien wat u verstuurt en wat u terugkrijgt.

  • Verzoeken en antwoorden zijn JSON
  • Een fout noemt het veld dat misging en waarom
  • Dezelfde aanroepen werken in de sandbox en in productie

Engine API

Voorbeeldverzoeken

POST/v1/releases

Request body

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

Response

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

Wat er rond de endpoints zit

De aanroepen zijn het korte deel van een integratie. Dit zijn de onderdelen die hem laten werken als niemand meekijkt.

Webhooks
Ontvang een gebeurtenis wanneer een levering van status verandert, een release live gaat of een afrekening klaar is, zodat u niet hoeft te pollen.
Idempotentiesleutels
Stuur een sleutel mee met een schrijfverzoek en een nieuwe poging geeft het eerste resultaat terug in plaats van een tweede release aan te maken.
Paginering
Lijsten geven een cursor terug. Geef die terug om de volgende pagina te krijgen, steeds in dezelfde volgorde.
Sandbox
Een aparte omgeving met eigen sleutels. Leveringen lopen van begin tot eind en stoppen vóór elke store.
Versiebeheer
De versie maakt deel uit van het pad. Een ingrijpende wijziging verschijnt onder een nieuwe versie, zodat de versie waartegen u hebt gebouwd ongewijzigd blijft.
Snelheidslimieten
Elk antwoord vertelt hoeveel van uw limiet er nog over is, en een beperkt verzoek vertelt wanneer u het opnieuw kunt proberen.

Van eerste sleutel tot live levering

  1. 1

    Haal uw sleutels op

    Vraag een account aan. Zodra het is goedgekeurd, maakt u een sandbox-sleutel aan.

  2. 2

    Bouw tegen de sandbox

    Maak releases aan en draai testleveringen tot uw integratie elke status aankan.

  3. 3

    Productietoegang aanvragen

    Vertel ons wat u bouwt. Wij beoordelen het en geven productiesleutels uit.

  4. 4

    Leveren

    Schakel over op de productiesleutel en dezelfde aanroepen bereiken echte stores.

Vragen over Engine

Nee. De referentie is openbaar. U hebt alleen een account nodig, dat we op aanvraag openen, wanneer u een sleutel wilt.

Ja. Een release die via de API is aangemaakt, verschijnt in het dashboard, en een release uit het dashboard kunt u via de API lezen en leveren.

De levering doorloopt dezelfde statussen als een echte en verstuurt dezelfde webhooks, maar er wordt niets naar een store gestuurd.

Doe uw eerste verzoek in de sandbox