Panoramica dell'API

L’API pubblica di LabelGrid permette agli sviluppatori di integrarsi con LabelGrid in modo programmatico: leggere il tuo catalogo, creare e aggiornare release, caricare asset e inviare le release alla distribuzione.

Cosa offre l’API

L’API pubblica è esposta sotto /api/public/... su api.labelgrid.com e dà accesso programmatico a:

Release — elencare, creare, aggiornare, eliminare; caricare l’artwork; validare; inviare alla distribuzione
Tracce — elencare, creare, aggiornare; caricare i file audio; gestire le licenze delle tracce
Etichette — elencare e gestire i profili delle tue etichette
Artisti — elencare e gestire i profili degli artisti
Autori e collaboratori — elencare e gestire i profili di autori e collaboratori
Editori — elencare e gestire i profili degli editori
Webhook — registrare gli endpoint webhook per le notifiche asincrone
Dati di riferimento — generi, lingue, ruoli dei collaboratori, strumenti, territori di distribuzione, outlet di distribuzione

Casi d’uso comuni

Automatizzare la creazione delle release a partire dai tuoi sistemi esistenti
Sincronizzare i dati del catalogo con il tuo database
Creare dashboard e strumenti di reportistica personalizzati
Integrare i tuoi strumenti di lavoro abituali
Alimentare servizi di distribuzione white-label costruiti su LabelGrid

Come ottenere l’accesso all’API

Per usare l’API di LabelGrid ti serve:

Un piano API attivo e a pagamento — l’accesso all’API e alla sandbox richiede un piano API a pagamento. La prova gratuita di 7 giorni inclusa nei piani standard non comprende l’accesso all’API o alla sandbox, e i piani API vengono fatturati subito (senza periodo di prova).
Un token API generato dalle impostazioni del tuo account: apri il menu dell’avatar in alto a destra e fai clic su API Tokens (visibile solo se l’accesso all’API è abilitato)
(Facoltativo) Whitelist di IP per maggiore sicurezza: si configura nella stessa sezione

Se non vedi l’opzione API Tokens nel tuo account, contatta l’assistenza per valutare l’attivazione dell’accesso all’API sul tuo piano.

Autenticazione

Tutte le richieste all’API devono includere un token Bearer nell’header Authorization:

Authorization: Bearer YOUR_API_TOKEN

Documentazione dell’API

Per il riferimento completo degli endpoint, gli schemi di richiesta/risposta e gli strumenti “try it” in tempo reale, consulta la documentazione generata automaticamente:

Produzione: https://api.labelgrid.com/docs/api
Sandbox: https://api-sandbox.stg.labelgrid.com/docs/api

La documentazione include:

Guida all’autenticazione
Ogni endpoint disponibile con esempi di richiesta e risposta
Informazioni sui limiti di frequenza (rate limiting)
Configurazione dei webhook

Sandbox

LabelGrid offre un ambiente sandbox in cui puoi sviluppare e fare test sull’API senza toccare il tuo catalogo di produzione. L’accesso alla sandbox richiede un piano API attivo e viene predisposto da noi su richiesta: una volta attivo il tuo piano API, contatta l’assistenza per configurarlo. La whitelist di IP per la sandbox la impostiamo noi; quella per la produzione la gestisci da solo in API Tokens.

Webhook

L’API pubblica supporta i webhook per la notifica asincrona degli eventi (cambi di stato della revisione, aggiornamenti delle consegne, ecc.). Per la configurazione e i tipi di evento disponibili, vedi Webhook.

Correlati

Stai costruendo qualcosa sull’API di LabelGrid? Dai un’occhiata all’hub per sviluppatori per una panoramica di cosa è possibile fare. Se alimenti un servizio di distribuzione white-label costruito su LabelGrid, la pagina infrastruttura per i distributori offre il quadro generale.

Hai bisogno di aiuto?

Se ti serve assistenza sull’API, contatta il nostro team di assistenza con i dettagli tecnici della tua integrazione.

Non usi ancora LabelGrid?

Tutto ciò che hai appena letto è disponibile sulla nostra piattaforma.

Scopri cosa può fare LabelGrid →