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
BeispielanfragenPOST/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
Schlüssel erhalten
Beantragen Sie ein Konto. Sobald es freigegeben ist, erstellen Sie einen Sandbox-Schlüssel.
- 2
In der Sandbox entwickeln
Erstellen Sie Releases und führen Sie Test-Auslieferungen aus, bis Ihre Integration jeden Status verarbeitet.
- 3
Produktionszugang anfordern
Sagen Sie uns, was Sie entwickeln. Wir prüfen es und stellen Produktionsschlüssel aus.
- 4
Ausliefern
Wechseln Sie zum Produktionsschlüssel, und dieselben Aufrufe erreichen echte Stores.