Autenticazione
Ottenere una chiave API
Puoi creare una chiave API nella pagina Integrazioni API nell’interfaccia Ignite Admin. Devi avere un ruolo admin per accedere a questa pagina.
Quando crei una chiave, scegli i suoi permessi e un eventuale ambito di categorie.
Permessi
I permessi della chiave API sono concessi per risorsa. Abilita solo le azioni di cui la tua integrazione ha bisogno.
| Risorsa | Azioni disponibili |
|---|---|
| Video | read, create, update, delete, publish |
| Eventi live | read, create, update, delete, publish |
| Tags | create, update, delete |
| Categorie | create, update, delete |
| Analytics | read |
L’accesso in lettura a categories e tags è sempre concesso. Non devi abilitarlo.
publish è separato da create e update. Per i video, impostare o modificare visibility su public richiede videos.publish. Senza di esso, i nuovi video restano private e gli aggiornamenti di visibilità vengono rifiutati.
Gli endpoint Analytics richiedono analytics.read. Il solo read sui video non basta. Vedi Analytics.
Le chiavi API non possono gestire membri, webhook, altre integrazioni API o le impostazioni dell’account.
Ambito di categorie
Puoi limitare una chiave API a una o più categorie. Se selezioni delle categorie, la chiave può accedere solo ai video in quelle categorie e nelle loro sottocategorie. Se lasci il campo vuoto, la chiave può accedere a tutte le categorie del workspace.
L’ambito di categorie si applica ai video e alle chiamate analytics per video. Non limita l’accesso agli eventi live.
Usare una chiave API
Passa la tua chiave API come Token Bearer nell’header Authorization della tua richiesta.
CURL
curl -X GET https://app.ignitevideo.cloud/api/videos \
-H "Authorization: Bearer YOUR_API_KEY"