Lesen Sie die gesamte API, bevor Sie den Antrag stellen

Die Engine-Referenz ist öffentlich. Ressourcen, Felder und Fehler sind mit Beispielen dokumentiert, und nichts davon liegt hinter einem Formular. Wenn Sie einen Aufruf ausprobieren möchten, beantragen Sie ein Konto und erstellen Sie einen Sandbox-Schlüssel.

Zum Lesen
Kein Konto nötig
Format
REST-Referenz mit Beispielen
Sandbox-Schlüssel
Mit einem freigegebenen Konto

Beginnen Sie mit einer Anfrage

Eine API versteht man am schnellsten, indem man sie aufruft. Diese vier Anfragen sind eine gute erste Stunde: Prüfen Sie, ob Ihr Schlüssel funktioniert, listen Sie auf, was vorhanden ist, erstellen Sie ein Release und abonnieren Sie Ereignisse.

  • Jeder Endpunkt wird mit Anfrage und Antwort gezeigt
  • Fehler sind mit Ursache und Lösung aufgeführt
  • Die Beispiele laufen unverändert gegen die Sandbox

Erste Anfragen

Beispielanfragen

GET/v1/me

Antwort

{  "id": "acc_5t1m9",  "name": "Northfield Audio",  "environment": "sandbox"}

Die Referenz nach Ressourcen

Releases
Erstellen, aktualisieren, einreichen und entfernen Sie Releases samt Territorien und Terminen.
Tracks und Assets
Fügen Sie Tracks hinzu, laden Sie Audio und Artwork hoch und legen Sie Credits, Codes und Splits fest.
Auslieferungen
Senden Sie ein Release an Stores und verfolgen Sie jedes Ziel von „in Warteschlange“ bis „live“ oder „abgelehnt“.
Analytics
Lesen Sie Streams und Downloads nach Store, Territorium, Release, Track und Tag.
Royalties
Listen Sie Abrechnungen auf, lesen Sie ihre Zeilen und sehen Sie, was jedem Zahlungsempfänger zusteht.
Webhooks
Registrieren Sie einen Endpunkt, wählen Sie die Ereignisse, die er erhält, und prüfen Sie, was gesendet wurde.

Schnellstart gegen die Sandbox

  1. 1

    Sandbox-Schlüssel erstellen

    Beantragen Sie ein Konto und kopieren Sie nach der Freigabe den Schlüssel daraus.

  2. 2

    Erste Anfrage senden

    Rufen Sie /v1/me mit dem Schlüssel im Authorization-Header auf, um zu bestätigen, dass er funktioniert.

  3. 3

    Test-Release erstellen

    Senden Sie per POST ein Release mit Titel und Artist und fügen Sie ihm dann einen Track hinzu.

  4. 4

    Auslieferung simulieren

    Liefern Sie es in der Sandbox aus und beobachten Sie, wie sich der Status bewegt – ganz ohne Store.

Ein Header, und Sie sind drin

Die Authentifizierung erfolgt über einen API-Schlüssel, der als Bearer-Token gesendet wird. Es gibt keinen Handshake und keine Sitzung, die am Leben gehalten werden muss. Kopieren Sie das, setzen Sie Ihren Schlüssel ein und führen Sie es aus.

  • Sandbox und Produktion verwenden getrennte Schlüssel
  • Ein Schlüssel kann jederzeit widerrufen werden

Ihre Releases auflisten

bash
curl https://api.aevorarecords.com/v1/releases \  -H "Authorization: Bearer YOUR_API_KEY"

Fragen zur Dokumentation

Nein. Die Referenz ist öffentlich. Ein Konto brauchen Sie nur, wenn Sie einen Schlüssel möchten.

Die Endpunkte und Antworten sind dieselben. Sandbox-Auslieferungen stoppen vor jedem Store, und Sandbox-Daten werden getrennt von Ihrem Live-Katalog geführt.

Ergänzungen werden im Changelog vermerkt. Eine inkompatible Änderung erscheint unter einer neuen Version im Pfad, sodass die Version, gegen die Sie entwickelt haben, unverändert bleibt.

Erst lesen, dann eine Anfrage senden