API REST

Ce que vous pouvez faire

• Envoyer vos vidéos directement vers le stockage, avec reprise possible pour les gros fichiers, envoyés en parties de 16 MB.
• Importer une vidéo depuis un lien vers un fichier.
• Consulter et gérer votre bibliothèque et vos webhooks depuis votre propre code.
• Récupérer vos statistiques dans un tableau de bord, un tableur ou un entrepôt de données (voir Statistiques plus bas).
• Donner à chaque clé uniquement l’accès dont elle a besoin : Read only, Read & write videos ou Admin.

Statistiques

Toute clé, y compris Read only, peut lire vos statistiques. Chaque période s’exprime en days (les N derniers jours, aujourd’hui compris) ou avec des dates from et to (AAAA-MM-JJ, toutes deux incluses).

• GET /v1/stats : totaux, lectures par jour, toutes les vidéos, pages les plus vues et campagnes UTM pour l’espace de travail, un dossier ou une étiquette. ?format=csv pour un tableur.
• GET /v1/videos/{id}/stats : une vidéo, avec sa rétention de l’audience, son taux d’achèvement, ses pays et ses appareils.
• GET /v1/analytics/sessions : chaque visionnage, du plus ancien au plus récent, jusqu’à 1 000 à la fois. Renvoyez la valeur next en tant que after pour obtenir la page suivante. Chaque visionnage indique le spectateur (s’il est connu), la part regardée, s’il a terminé la vidéo, le pays, l’appareil, la page, les paramètres UTM et ce sur quoi il a cliqué ou ce qu’il a envoyé.
• GET /v1/analytics/viewer?email=… : tout ce qu’une personne a regardé, vidéo par vidéo, toutes ses sessions réunies.
• POST /v1/analytics/report : un rapport personnalisé (regroupement et indicateurs, comme dans Analytics → Reports), et GET /v1/analytics/reports/{id}/run exécute un rapport enregistré par votre équipe à cet endroit.
• GET /v1/analytics/compare?videos=… et GET /v1/analytics/live : comparer des vidéos, et voir qui regarde en ce moment.

Mise en place

1. Dans Pellio, allez dans Settings → Developers. Vous devez être propriétaire ou administrateur.
2. Créez une clé : donnez-lui un nom et choisissez son niveau d’accès (Access).
3. Copiez la clé. Elle ne s’affiche qu’une fois : conservez-la en lieu sûr.
4. Envoyez-la sous forme de jeton Bearer : curl https://api.pellio.io/v1/videos -H "Authorization: Bearer pk_…"
5. Pour mettre une vidéo en ligne, appelez POST /v1/videos/uploads, envoyez le fichier avec PUT à l’URL renvoyée, puis appelez POST /v1/videos/{id}/complete. Un webhook video.ready vous prévient quand le traitement est terminé.

Bon à savoir

• Tous les endpoints figurent dans la référence de l’API, et le document OpenAPI se trouve à l’adresse https://api.pellio.io/v1/openapi.json.
• Les fichiers doivent être des vidéos ou de l’audio, jusqu’à 20 GB. Les URL d’envoi sont valables 6 heures.
• Chaque clé peut envoyer 600 requêtes par minute et lancer 30 imports par minute. Une réponse 429 signifie qu’il faut ralentir et réessayer.
• La liste des clés indique la dernière utilisation de chacune. Revoke désactive une clé immédiatement.
• Nécessite le forfait Standard ou supérieur.

Guide complet : Clés API.