Authentifizierung

API-Key erhalten

Du kannst einen API-Key auf der Seite API Integrations in der Ignite-Admin-Oberfläche erstellen. Du brauchst die Rolle admin, um auf diese Seite zuzugreifen.

Wenn du einen Key erstellst, wählst du seine Berechtigungen und optional einen Kategorie-Scope.

Berechtigungen

API-Key-Berechtigungen werden pro Ressource vergeben. Aktiviere nur die Aktionen, die deine Integration braucht.

Ressource	Verfügbare Aktionen
Videos	`read`, `create`, `update`, `delete`, `publish`
Live-Events	`read`, `create`, `update`, `delete`, `publish`
Tags	`create`, `update`, `delete`
Kategorien	`create`, `update`, `delete`
Analytics	`read`

Lesezugriff auf Kategorien und Tags ist immer gewährt. Du musst ihn nicht aktivieren.

publish ist getrennt von create und update. Für Videos erfordert das Setzen oder Ändern von visibility auf public die Berechtigung videos.publish. Ohne sie bleiben neue Videos private, und Sichtbarkeits-Updates werden abgelehnt.

Analytics-Endpoints erfordern analytics.read. Video-read allein reicht nicht. Siehe Analytics.

API-Keys können keine Mitglieder, Webhooks, andere API-Integrationen oder Account-Einstellungen verwalten.

Kategorie-Scope

Du kannst einen API-Key auf eine oder mehrere Kategorien beschränken. Wenn du Kategorien auswählst, kann der Key nur auf Videos in diesen Kategorien und ihren Unterkategorien zugreifen. Lässt du das Feld leer, kann der Key auf alle Kategorien im Workspace zugreifen.

Kategorie-Scope gilt für Videos und für Analytics-Aufrufe pro Video. Er beschränkt nicht den Zugriff auf Live-Events.

API-Key verwenden

Übergib deinen API-Key als Bearer-Token im Authorization-Header deiner Anfrage.

CURL


curl -X GET https://app.ignitevideo.cloud/api/videos \
-H "Authorization: Bearer YOUR_API_KEY"

JavaScript / Node.js


const response = await fetch('https://app.ignitevideo.cloud/api/videos', {
headers: {
  Authorization: `Bearer YOUR_API_KEY`
}
});

PHP


$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://app.ignitevideo.cloud/api/videos', [
'headers' => [
  'Authorization' => 'Bearer YOUR_API_KEY'
]
]);