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 esempio

GET/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. 1

    Crea una chiave sandbox

    Richiedi un account e, dopo l'approvazione, copia la chiave da lì.

  2. 2

    Fai la tua prima richiesta

    Chiama /v1/me con la chiave nell’intestazione Authorization per confermare che funzioni.

  3. 3

    Crea un’uscita di prova

    Invia un’uscita con titolo e artista, poi aggiungi un brano.

  4. 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

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

Domande sulla documentazione

No. Il riferimento è pubblico. Serve un account solo quando vuoi una chiave.

Gli endpoint e le risposte sono gli stessi. Le consegne in sandbox si fermano prima di qualsiasi store, e i dati della sandbox restano separati dal tuo catalogo reale.

Le aggiunte vengono annotate nel changelog. Una modifica non retrocompatibile esce con una nuova versione nel percorso, così la versione su cui hai sviluppato resta com’è.

Prima leggi, poi fai una richiesta