Pourquoi une API vidéo
Une interface web suffit pour un usage ponctuel ; une API devient nécessaire dès qu'un autre système doit agir sur les vidéos sans un humain qui clique. Trois usages reviennent le plus souvent.
- Import automatique depuis un LMS, un CRM ou un outil de montage
- Synchronisation de métadonnées entre la plateforme vidéo et un autre système
- Récupération de statistiques pour un tableau de bord interne
- Automatisation d'un workflow de publication (mise en ligne, mise à jour, suppression)
API REST et SDK
Une API vidéo s'utilise de deux façons : des appels HTTP directs à l'API REST, ou un SDK qui encapsule ces appels dans le langage utilisé. Le choix dépend surtout de la fréquence d'usage et du besoin de fonctionnalités comme la reprise d'un envoi interrompu.
| Approche | Ce qu'elle apporte | Idéal pour |
|---|
| API REST | Appels HTTP directs, aucune dépendance à installer | Scripts ponctuels, langages sans SDK dédié |
| SDK | Fonctions prêtes à l'emploi, gestion des erreurs et des envois volumineux | Intégrations durables en JavaScript, TypeScript ou Python |
L'API Videas
L'API Videas est exposée sur `https://app.videas.com/api/external/` et authentifiée par un token personnel, envoyé en jeton `Authorization: Bearer`. Chaque token se crée depuis Paramètres → Accès API, avec des scopes de la forme `<ressource>:<action>` — `assets:read`, `files:write`, etc. — et une expiration configurable, pour appliquer le principe du moindre privilège. Elle couvre l'envoi de fichiers, la lecture, les domaines autorisés à embarquer le lecteur et la gestion des dossiers. Les envois passent par le protocole reprenable TUS, donc un transfert coupé repart où il s'est arrêté plutôt que de tout recommencer. Deux SDK encapsulent ces appels — `@videas/sdk` en JavaScript/TypeScript, `videas-sdk` en Python — mais l'API REST seule suffit pour qui préfère des appels HTTP simples. La documentation interactive, générée depuis le code (OpenAPI), liste l'ensemble des endpoints et permet de tester un appel directement avec son propre token. Rien n'oblige à s'en servir : l'interface web couvre l'usage courant, l'API reste réservée à ce qu'elle seule sait automatiser.
Questions fréquentes
Que signifie API ?+
API signifie Application Programming Interface, interface de programmation : le point d'entrée qui permet à un logiciel externe de dialoguer avec une plateforme par le code plutôt que par son interface web.
Faut-il utiliser l'API pour utiliser Videas ?+
Non. L'interface web suffit pour un usage courant, import, organisation et partage compris. L'API sert à ce que l'interface ne fait pas : automatiser, intégrer un autre outil, ou agir sur les vidéos sans intervention manuelle.
Comment s'authentifier auprès de l'API Videas ?+
Avec un token personnel créé depuis Paramètres → Accès API, envoyé sur chaque requête dans le header `Authorization: Bearer <token>`. La valeur complète n'est affichée qu'une seule fois, à la création.
L'API Videas propose-t-elle un SDK ?+
Deux : `@videas/sdk` pour JavaScript et TypeScript, `videas-sdk` pour Python. L'API REST seule suffit aussi, avec un client HTTP classique et un token en Bearer.
Que couvre l'API Videas ?+
L'envoi de fichiers, la lecture, les domaines autorisés à embarquer le lecteur et la gestion des dossiers, avec des scopes granulaires par ressource et par action.
Que se passe-t-il si un envoi est interrompu ?+
Rien à refaire depuis le début : les envois passent par le protocole reprenable TUS, qui reprend le transfert là où il s'est arrêté.
Où trouver la liste des endpoints disponibles ?+
Dans la documentation interactive, générée automatiquement depuis le code (OpenAPI), qui reste donc toujours à jour avec ce que le serveur expose réellement.
Les tokens API sont-ils partagés entre collègues ?+
Non. Chaque membre de l'équipe crée ses propres tokens, rattachés à son compte, ce qui permet de tracer qui fait quoi et de révoquer un accès sans casser les intégrations des autres.