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
BeispielanfragenGET/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
Sandbox-Schlüssel erstellen
Beantragen Sie ein Konto und kopieren Sie nach der Freigabe den Schlüssel daraus.
- 2
Erste Anfrage senden
Rufen Sie /v1/me mit dem Schlüssel im Authorization-Header auf, um zu bestätigen, dass er funktioniert.
- 3
Test-Release erstellen
Senden Sie per POST ein Release mit Titel und Artist und fügen Sie ihm dann einen Track hinzu.
- 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
bashcurl https://api.aevorarecords.com/v1/releases \ -H "Authorization: Bearer YOUR_API_KEY"