# REST API voor OTT-platforms | Vodlix **Source:** https://vodlix.com/nl/features/restful-api **Summary:** Stuur uw streamingplatform aan met code. Beheer video's, series, livekanalen, artwork en contentlijsten via een API die alles van de beheeromgeving dekt. **Publisher:** Vodlix --- ## Restful API Krijg een krachtige, veilige REST API om snel te integreren, processen te automatiseren en workflows te stroomlijnen. - **Feature Plan:** 2 - core-platform - back-end ## REST API voor uw streamingplatform Stuur catalogus, artwork, livekanalen, merchandising en rapportages aan via een REST API die de beheeromgeving weerspiegelt. De aanroep ‘Add New Video’ in de API-documentatie van het platform op een laptop, met dezelfde titel geopend in een telefoonapp API-documentatie voor ‘Update Content Thumbs’, waarmee de staande, liggende en logo-artwork van een titel via afbeeldings-URL's wordt ingesteld ### Artwork en livekanalen via API Via de Vodlix API wordt artwork per URL gekoppeld in plaats van handmatig geüpload. Eén aanroep stelt de staande, liggende en logo-afbeeldingen van een titel in, een andere kiest welk gegenereerd frame als thumbnail dient. Livekanalen worden behandeld als video's: aangemaakt vanaf een stream-URL, bijgewerkt, gepubliceerd of gedepubliceerd, en naar de prullenbak verplaatst of hersteld, zodat lineaire content net zo wordt geautomatiseerd als on-demandcontent. Bij een grote of vaak wijzigende catalogus blijft artwork zo consistent zonder dat iemand bestanden een voor een hoeft te uploaden. #### REST API Vertrouwd en voorspelbaar. #### Weerspiegelt de beheeromgeving Kent u de interface, dan kent u de API. #### Volledige levenscyclus Aanmaken, publiceren, depubliceren, herstellen. API-documentatie voor ‘Upload with URL’, waarmee een video wordt ingeladen vanaf een bestands-URL op openbare, S3- of Wasabi-opslag ### Beheer de catalogus programmatisch Met de Vodlix REST API stuurt u de catalogus programmatisch aan, net als in de beheeromgeving. Video's kunnen worden aangemaakt, bijgewerkt, gepubliceerd of gedepubliceerd, en naar de prullenbak verplaatst of hersteld. Series en seizoenen worden op dezelfde manier aangemaakt, bijgewerkt en gepubliceerd, en afleveringen worden aan een seizoen gekoppeld of ervan losgekoppeld. Nieuwe video's worden ingeladen door het platform een bestands-URL te geven, openbaar of in uw eigen S3- of Wasabi-opslag: het haalt het bestand op, verwerkt het op de achtergrond en geeft een video-ID terug waarmee u het volgt. Voor OTT-operators met bestaande systemen kan catalogusbeheer worden geautomatiseerd in plaats van met de hand gedaan. Homepage van de storefront met de rijen ‘Top 10’ en ‘Rent the Latest’, contentlijsten die met een API-aanroep aan en uit kunnen ### Merchandising en contentlijsten onder API-controle De Vodlix API geeft u controle over merchandising: contentlijsten, lijstgroepen, hun items en hun volgorde kunnen allemaal programmatisch worden aangemaakt en beheerd. Lijsten kunnen worden geactiveerd en gedeactiveerd, zodat een seizoensrij met een API-aanroep wordt uitgeschakeld in plaats van opnieuw opgebouwd. Zo kunnen planningssystemen en tools voor contentplanning de homepage automatisch vormgeven. Merchandising onder API-controle is wat redactionele workflows laat meegroeien. - mx-auto Tabel met MCP Access-tools voor platforminformatie, content- en gebruikersaantallen, catalogus doorbladeren en een verkoopoverzicht ### Referentie- en rapportage-endpoints De Vodlix API biedt referentie- en rapportage-aanroepen: categorie-ID's, catalogus- en gebruikersaantallen, een verkoopoverzicht voor elk gewenst datumbereik en platformgegevens zoals de softwareversie. Integraties weten altijd waarmee ze werken en kunnen zich aanpassen aan wijzigingen in het platform. Toegang verloopt via API-sleutels die in de beheeromgeving worden aangemaakt: een serversleutel voor back-endtaken en een clientsleutel voor browsercode, die nooit bij beheerroutes kan komen. Dezelfde aanroepen zijn beschikbaar voor AI-assistenten via de MCP-connector van het platform. ### Waar de API zich meestal terugverdient De gebruikelijke toepassingen zijn migratie, ingest en rapportage. Een catalogus overzetten vanaf een ander platform is een API-taak in plaats van handwerk, en dat is het verschil tussen een lancering die op niemand wacht en een die in maanden wordt gemeten. Terugkerende ingest van een distributeur of uit een productieworkflow draait zonder toezicht zodra die eenmaal is geschreven. Rapportage zet cijfers in de tools die uw financiële team al gebruikt, in plaats van iemand elke maandag een scherm te laten exporteren. Daarnaast verbindt de API uw platform met de rest van uw bedrijf. Zet een nieuwe titel in uw CMS en op uw marketingwebsite zodra die wordt gepubliceerd, of geef uw [contentlijsten](/nl/features/content-lists) door aan een aanbevelingsdienst en schrijf de resultaten terug. Heeft een integratie meer nodig dan de API alleen biedt, dan bouwt onze [service voor maatwerkplug-ins](/nl/services/custom-plugin) het ontbrekende stuk op hetzelfde platform. Analytics zijn via de API beschikbaar wanneer er een statistiekdienst op uw cloud is geconfigureerd. Dat bevestigt u het best tijdens de inrichting in plaats van het later te ontdekken. De pagina [rapportages en analytics](/nl/features/reports-and-analytics) laat zien wat er wordt gemeten. **Q: Wat kan de Vodlix REST API aansturen?** De Vodlix REST API beheert de catalogus, waaronder video's, series, seizoenen en afleveringen, plus artwork, livekanalen, contentlijsten en merchandising, en referentie- en rapportagegegevens. **Q: Upload ik videobestanden via de Vodlix API?** Nieuwe video's worden via de Vodlix API ingeladen door een openbare HTTPS-URL op te geven. Vodlix haalt het bestand op en transcodeert het, zodat u geen binaire uploads via uw eigen infrastructuur hoeft te streamen. **Q: Komt de Vodlix API overeen met de beheeromgeving?** Ja. De Vodlix REST API weerspiegelt de beheeromgeving, met vertrouwde REST-conventies en voorspelbare antwoorden, dus wie de interface kent, weet ongeveer wat de API kan. **Q: Kan ik contentlijsten beheren via de Vodlix API?** Ja. Vodlix-contentlijsten, lijstgroepen, hun items en hun volgorde kunnen allemaal via de API worden aangemaakt, bijgewerkt, geactiveerd en gedeactiveerd, zodat merchandising kan worden geautomatiseerd. **Q: Welke rapportagegegevens levert de Vodlix API?** De Vodlix API levert catalogus- en gebruikersaantallen, een verkoopoverzicht voor een datumbereik, categorie-ID's en platformgegevens zoals de softwareversie, zodat integraties altijd weten waarmee ze werken. **Q: Zijn categorie-ID's op elke Vodlix-cloud hetzelfde?** Nee, en dit is de meest gemaakte fout. Categorieën gelden per cloud. Lees dus de categorielijst uit van het platform waarmee u werkt en gebruik de ID's die het teruggeeft, in plaats van aan te nemen dat een naam overal hetzelfde nummer heeft. **Q: Kunnen we analytics via de API ophalen?** Ja, wanneer er een statistiekdienst op uw cloud is geconfigureerd, met de belangrijkste cijfers, realtime activiteit en best presterende content. Bevestig dat tijdens de inrichting, want deze dienst wordt los van de catalogusfuncties ingericht. **Q: Is de API nuttig om te migreren vanaf een ander platform?** Het is een van de meest voorkomende redenen waarom operators de API gebruiken. Door een catalogus programmatisch over te zetten, wordt een migratie een herhaalbare taak in plaats van maandenlang handmatig invoeren, en die kan opnieuw worden uitgevoerd om alles op te vangen wat tijdens de overstap is gewijzigd. **Q: Hoe authenticeren integraties zich bij de Vodlix API?** Met een API-sleutel die in de beheeromgeving onder ‘Apps & APIs’ wordt aangemaakt en in de header X-Api-Key wordt meegestuurd. Een serversleutel handelt met de rechten van de gebruiker aan wie hij toebehoort en kan bij beheerroutes komen, dus hoort thuis op een back-end. Een clientsleutel is veilig voor browsercode en wordt geblokkeerd op elke beheerroute. Sleutels kunnen een vervaldatum hebben, en een sleutel verwijderen trekt hem direct in.