Steuern Sie den Vertrieb aus Ihrem eigenen Produkt

Engine ist die Aevora-API. Erstellen Sie Releases, liefern Sie sie an Stores aus, lesen Sie Analytics und führen Sie Royalty-Abrechnungen per REST aus – direkt in dem Produkt, das Ihre Kunden bereits nutzen. Die Dokumentation ist öffentlich, und zum Entwickeln steht eine Sandbox bereit.

Schnittstelle
REST und JSON
Authentifizierung
API-Schlüssel, ein Satz pro Umgebung
Sandbox
Test-Auslieferungen, ohne dass Stores beteiligt sind

Vier Aufrufe führen ein Release vom Entwurf zur Abrechnung

Die API folgt dem Weg, den ein Release im Dashboard nimmt: anlegen, ausliefern, die Zahlen lesen, sobald sie eintreffen, und dann die Abrechnung lesen. Wählen Sie einen Aufruf, um zu sehen, was Sie senden und was zurückkommt.

  • Anfragen und Antworten sind JSON
  • Ein Fehler nennt das Feld, das fehlgeschlagen ist, und den Grund
  • Dieselben Aufrufe funktionieren in der Sandbox und in der Produktion

Engine API

Beispielanfragen

POST/v1/releases

Request-Body

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

Antwort

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

Was um die Endpunkte herum liegt

Die Aufrufe sind der kurze Teil einer Integration. Das hier sind die Teile, die sie am Laufen halten, wenn niemand hinsieht.

Webhooks
Erhalten Sie ein Ereignis, wenn sich der Status einer Auslieferung ändert, ein Release live geht oder eine Abrechnung bereitsteht – Polling ist nicht nötig.
Idempotenzschlüssel
Senden Sie mit einer Schreibanfrage einen Schlüssel, und ein erneuter Versuch liefert das erste Ergebnis zurück, statt ein zweites Release anzulegen.
Paginierung
Listen liefern einen Cursor. Geben Sie ihn zurück, um die nächste Seite zu erhalten – immer in derselben Reihenfolge.
Sandbox
Eine getrennte Umgebung mit eigenen Schlüsseln. Auslieferungen laufen von Anfang bis Ende durch und stoppen vor jedem Store.
Versionierung
Die Version ist Teil des Pfads. Eine inkompatible Änderung erscheint unter einer neuen Version, sodass die Version, gegen die Sie entwickelt haben, unverändert bleibt.
Ratenlimits
Jede Antwort nennt, wie viel Ihres Kontingents noch übrig ist, und eine begrenzte Anfrage sagt Ihnen, wann Sie es erneut versuchen können.

Vom ersten Schlüssel zur Live-Auslieferung

  1. 1

    Schlüssel erhalten

    Beantragen Sie ein Konto. Sobald es freigegeben ist, erstellen Sie einen Sandbox-Schlüssel.

  2. 2

    In der Sandbox entwickeln

    Erstellen Sie Releases und führen Sie Test-Auslieferungen aus, bis Ihre Integration jeden Status verarbeitet.

  3. 3

    Produktionszugang anfordern

    Sagen Sie uns, was Sie entwickeln. Wir prüfen es und stellen Produktionsschlüssel aus.

  4. 4

    Ausliefern

    Wechseln Sie zum Produktionsschlüssel, und dieselben Aufrufe erreichen echte Stores.

Fragen zu Engine

Nein. Die Referenz ist öffentlich. Ein Konto, das wir auf Antrag eröffnen, brauchen Sie nur, wenn Sie einen Schlüssel möchten.

Ja. Ein Release, das über die API erstellt wurde, erscheint im Dashboard, und ein im Dashboard erstelltes Release lässt sich über die API lesen und ausliefern.

Die Auslieferung durchläuft dieselben Status wie eine echte und sendet dieselben Webhooks, aber es wird nichts an einen Store geschickt.

Stellen Sie Ihre erste Anfrage in der Sandbox