Uwierzytelnianie
Uzyskanie klucza API
Możesz utworzyć klucz API na stronie Integracje API w Ignite Admin UI. Potrzebujesz roli admin, żeby wejść na tę stronę.
Podczas tworzenia klucza wybierz jego uprawnienia oraz opcjonalny zakres kategorii.
Uprawnienia
Uprawnienia klucza API są przyznawane per zasób. Włącz tylko te akcje, których potrzebuje twoja integracja.
| Zasób | Dostępne akcje |
|---|---|
| Wideo | read, create, update, delete, publish |
| Wydarzenia na żywo | read, create, update, delete, publish |
| Tags | create, update, delete |
| Kategorie | create, update, delete |
| Analytics | read |
Dostęp do odczytu kategorii i Tags jest zawsze przyznany. Nie musisz go włączać.
publish jest oddzielne od create i update. Dla wideo ustawienie lub zmiana visibility na public wymaga videos.publish. Bez tego nowe wideo pozostają private, a aktualizacje widoczności są odrzucane.
Endpointy Analytics wymagają analytics.read. Samo read dla wideo nie wystarczy. Zobacz Analytics.
Klucze API nie mogą zarządzać członkami, webhookami, innymi integracjami API ani ustawieniami konta.
Zakres kategorii
Możesz ograniczyć klucz API do jednej lub wielu kategorii. Jeśli wybierzesz kategorie, klucz będzie miał dostęp tylko do wideo w tych kategoriach i ich podkategoriach. Jeśli zostawisz pole puste, klucz będzie miał dostęp do wszystkich kategorii w workspace.
Zakres kategorii dotyczy wideo oraz wywołań analytics per wideo. Nie ogranicza dostępu do wydarzeń na żywo.
Użycie klucza API
Przekaż swój klucz API jako token Bearer w nagłówku Authorization swojego żądania.
CURL
curl -X GET https://app.ignitevideo.cloud/api/videos \
-H "Authorization: Bearer YOUR_API_KEY"