# REST API dla platform OTT | Vodlix

**Source:** https://vodlix.com/pl/features/restful-api  
**Summary:** Steruj platformą streamingową z poziomu kodu. Zarządzaj filmami, serialami, kanałami na żywo, grafikami i listami treści przez API obejmujące cały panel.  
**Publisher:** Vodlix

---

## Restful API

Zyskaj wydajne i bezpieczne REST API, aby szybko integrować systemy, automatyzować procesy i usprawniać przepływy pracy.

- **Feature Plan:** 2

- core-platform
- back-end

## REST API dla Twojej platformy streamingowej

Steruj katalogiem, grafikami, kanałami na żywo, merchandisingiem i raportami przez REST API, które odzwierciedla panel administracyjny.

Wywołanie „Add New Video» w dokumentacji API platformy na laptopie, obok ten sam tytuł otwarty w aplikacji na telefonie

Dokumentacja API dla „Update Content Thumbs”, które ustawia pionową, poziomą i logotypową grafikę tytułu na podstawie adresów URL obrazów

### Grafiki i kanały na żywo przez API

Dzięki API Vodlix grafiki przypisuje się przez URL, zamiast przesyłać je ręcznie. Jedno wywołanie ustawia pionowy, poziomy i logotypowy obraz tytułu, a drugie wybiera, która wygenerowana klatka posłuży za miniaturę. Kanały na żywo obsługuje się jak filmy: tworzy się je z adresu URL streamu, aktualizuje, publikuje lub wycofuje, przenosi do kosza lub przywraca, więc treści linearne automatyzuje się tak samo jak treści na żądanie. Przy dużym lub często zmieniającym się katalogu grafiki pozostają spójne, a nikt nie musi przesyłać plików pojedynczo.

#### REST API

Znajome i przewidywalne.

#### Odzwierciedla panel

Znasz interfejs – znasz API.

#### Pełny cykl życia

Twórz, publikuj, wycofuj, przywracaj.

Dokumentacja API dla „Upload with URL”, które pobiera wideo z adresu URL pliku w publicznym magazynie, S3 lub Wasabi

### Zarządzaj katalogiem programowo

REST API Vodlix pozwala sterować katalogiem programowo, tak samo jak w panelu administracyjnym. Filmy można tworzyć, aktualizować, publikować lub wycofywać z publikacji, a także przenosić do kosza lub przywracać. Seriale i sezony tworzy się, aktualizuje i publikuje w ten sam sposób, a odcinki przypisuje się do sezonu lub od niego odłącza. Nowe wideo trafia do systemu po przekazaniu platformie adresu URL pliku – publicznego lub z Twojej własnej przestrzeni S3 czy Wasabi: platforma pobiera i przetwarza plik w tle, a następnie zwraca identyfikator wideo, dzięki któremu możesz śledzić postęp. Operatorzy OTT z istniejącymi systemami mogą zautomatyzować zarządzanie katalogiem, zamiast robić to ręcznie.

Strona główna sklepu z rzędami „Top 10” i „Rent the Latest” – listami treści, które można włączać i wyłączać wywołaniem API

### Merchandising i listy treści pod kontrolą API

API Vodlix daje Ci kontrolę nad merchandisingiem: listy treści, grupy list, ich elementy i kolejność można tworzyć i zarządzać nimi programowo. Listy można aktywować i dezaktywować, więc sezonowy rząd wyłączasz jednym wywołaniem API, zamiast budować go od nowa. Dzięki temu systemy planowania emisji i narzędzia do planowania treści mogą automatycznie kształtować stronę główną. To właśnie merchandising pod kontrolą API pozwala skalować procesy redakcyjne.

- mx-auto

Tabela narzędzi MCP Access z informacjami o platformie, liczbą treści i użytkowników, przeglądaniem katalogu i podsumowaniem sprzedaży

### Endpointy referencyjne i raportowe

API Vodlix oferuje wywołania referencyjne i raportowe: identyfikatory kategorii, liczbę pozycji w katalogu i użytkowników, podsumowanie sprzedaży dla dowolnego zakresu dat oraz dane platformy, takie jak wersja oprogramowania. Integracje zawsze wiedzą, z czym pracują, i mogą dostosować się do zmian platformy. Dostęp odbywa się za pomocą kluczy API tworzonych w panelu: klucza serwerowego do zadań back-endowych i klucza klienckiego do kodu w przeglądarce, który nigdy nie ma dostępu do tras administracyjnych. Te same wywołania są udostępniane asystentom AI przez konektor MCP platformy.

### Gdzie zwykle się opłaca

Najczęstsze zastosowania to migracja, ingest i raportowanie. Przeniesienie katalogu z innej platformy to zadanie dla API, a nie ręczna praca – i właśnie to odróżnia start, który nie czeka na nikogo, od takiego, który trwa miesiącami. Cykliczny ingest od dystrybutora lub z procesu produkcyjnego działa bez nadzoru, gdy tylko zostanie napisany. Raportowanie przenosi dane do narzędzi, których Twój dział finansów już używa, zamiast prosić kogoś o eksport ekranu w każdy poniedziałek.

API łączy też Twoją platformę z resztą firmy. Przekaż nowy tytuł do swojego CMS i na stronę marketingową w chwili publikacji albo przekaż swoje [listy treści](/pl/features/content-lists) do usługi rekomendacji i zapisz wyniki z powrotem. Gdy integracja potrzebuje czegoś więcej, niż oferuje samo API, nasza [usługa tworzenia wtyczek na zamówienie](/pl/services/custom-plugin) zbuduje brakujący element na tej samej platformie.

Analityka jest dostępna przez API, jeśli w Twojej chmurze skonfigurowano usługę statystyk – warto to potwierdzić na etapie wdrożenia, a nie odkrywać później. Na stronie [raporty i analityka](/pl/features/reports-and-analytics) znajdziesz opis tego, co jest mierzone.

**Q: Czym może sterować REST API Vodlix?**

REST API Vodlix steruje katalogiem, w tym filmami, serialami, sezonami i odcinkami, a także grafikami, kanałami na żywo, listami treści i merchandisingiem oraz danymi referencyjnymi i raportowymi.

**Q: Czy pliki wideo przesyłam przez API Vodlix?**

Nowe wideo trafia do systemu przez API Vodlix po podaniu publicznego adresu URL HTTPS. Vodlix pobiera i transkoduje plik, więc nie musisz przesyłać danych binarnych przez własną infrastrukturę.

**Q: Czy API Vodlix odpowiada panelowi administracyjnemu?**

Tak. REST API Vodlix odzwierciedla panel administracyjny, ze znanymi konwencjami REST i przewidywalnymi odpowiedziami, więc każdy, kto zna interfejs, wie mniej więcej, co potrafi API.

**Q: Czy mogę zarządzać listami treści przez API Vodlix?**

Tak. Listy treści Vodlix, grupy list, ich elementy i kolejność można tworzyć, aktualizować, aktywować i dezaktywować przez API, dzięki czemu merchandising można zautomatyzować.

**Q: Jakie dane raportowe udostępnia API Vodlix?**

API Vodlix udostępnia liczbę pozycji w katalogu i użytkowników, podsumowanie sprzedaży dla wybranego zakresu dat, identyfikatory kategorii oraz dane platformy, takie jak wersja oprogramowania, dzięki czemu integracje zawsze wiedzą, z czym pracują.

**Q: Czy identyfikatory kategorii są takie same w każdej chmurze Vodlix?**

Nie, i to najczęstszy błąd. Kategorie są przypisane do konkretnej chmury, więc odczytaj listę kategorii platformy, z którą pracujesz, i używaj zwróconych identyfikatorów, zamiast zakładać, że dana nazwa wszędzie ma ten sam numer.

**Q: Czy możemy pobierać analitykę przez API?**

Tak, jeśli w Twojej chmurze skonfigurowano usługę statystyk – obejmuje ona kluczowe wskaźniki, aktywność w czasie rzeczywistym i najpopularniejsze treści. Warto to potwierdzić na etapie wdrożenia, ponieważ usługa jest uruchamiana niezależnie od operacji na katalogu.

**Q: Czy API przydaje się przy migracji z innej platformy?**

To jeden z najczęstszych powodów, dla których operatorzy z niego korzystają. Programowe przeniesienie katalogu zamienia migrację w powtarzalne zadanie zamiast miesięcy ręcznego wprowadzania danych, a proces można uruchomić ponownie, aby wychwycić wszystko, co zmieniło się w trakcie przenosin.

**Q: Jak integracje uwierzytelniają się w API Vodlix?**

Za pomocą klucza API utworzonego w panelu w sekcji „Apps & APIs” i wysyłanego w nagłówku X-Api-Key. Klucz serwerowy działa z uprawnieniami użytkownika, do którego należy, i ma dostęp do tras administracyjnych, dlatego powinien być używany na back-endzie. Klucz kliencki jest bezpieczny w kodzie przeglądarki i ma zablokowany dostęp do wszystkich tras administracyjnych. Klucze mogą mieć datę wygaśnięcia, a usunięcie klucza natychmiast go unieważnia.