Leggi tutta l'API prima di fare richiesta
Il riferimento di Engine è aperto. Risorse, campi ed errori sono documentati con esempi, e nulla è dietro un modulo. Quando vuoi provare una chiamata, richiedi un account e crea una chiave sandbox.
- Da leggere
- Nessun account necessario
- Formato
- Riferimento REST con esempi
- Chiavi sandbox
- Con un account approvato
Parti da una richiesta
Il modo più rapido per leggere un’API è chiamarla. Queste quattro richieste sono una buona prima ora: verificare che la chiave funzioni, elencare cosa c’è, creare un’uscita e sottoscrivere gli eventi.
- Ogni endpoint è mostrato con una richiesta e una risposta
- Gli errori sono elencati con causa e soluzione
- Gli esempi funzionano in sandbox così come sono scritti
Prime richieste
Richieste di esempioGET/v1/me
Risposta
{ "id": "acc_5t1m9", "name": "Northfield Audio", "environment": "sandbox"}La documentazione, per risorsa
- Uscite
- Crea, aggiorna, invia e rimuovi uscite, con i relativi territori e date.
- Brani e file
- Aggiungi brani, carica audio e copertine e imposta crediti, codici e split.
- Consegne
- Invia un’uscita agli store e segui ogni destinazione dalla coda fino all’online o al rifiuto.
- Analytics
- Leggi stream e download per store, territorio, uscita, brano e giorno.
- Royalty
- Elenca i rendiconti, leggi le loro righe e vedi quanto spetta a ciascun beneficiario.
- Webhook
- Registra un endpoint, scegli gli eventi che riceve e rivedi cosa è stato inviato.
Guida rapida, sulla sandbox
- 1
Crea una chiave sandbox
Richiedi un account e, dopo l'approvazione, copia la chiave da lì.
- 2
Fai la tua prima richiesta
Chiama /v1/me con la chiave nell’intestazione Authorization per confermare che funzioni.
- 3
Crea un’uscita di prova
Invia un’uscita con titolo e artista, poi aggiungi un brano.
- 4
Simula una consegna
Consegnala in sandbox e guarda lo stato avanzare, senza alcuno store coinvolto.
Un’intestazione e sei dentro
L’autenticazione è una chiave API inviata come bearer token. Non c’è handshake e nessuna sessione da mantenere attiva. Copia questo, inserisci la tua chiave ed eseguilo.
- Sandbox e produzione usano chiavi separate
- Una chiave può essere revocata in qualsiasi momento
Elenca le tue uscite
bashcurl https://api.aevorarecords.com/v1/releases \ -H "Authorization: Bearer YOUR_API_KEY"