Clés API et API REST

Créez des clés dans Settings → Developers (propriétaires et administrateurs). Donnez un nom à la clé et choisissez son niveau d’accès (Access) : Read only (lecture seule, comme un Viewer), Read & write videos (lecture et écriture des vidéos, comme un Member) ou Admin. La clé ne s’affiche qu’une fois : conservez-la en lieu sûr. La liste des clés indique le niveau d’accès de chacune, sa dernière utilisation, et propose Revoke.

Chaque clé indique sa dernière utilisation. Revoke la désactive aussitôt : tout ce qui l’utilise cesse immédiatement de fonctionner.

Envoyez la clé sous forme de jeton Bearer :

curl https://api.pellio.io/v1/videos 
  -H "Authorization: Bearer pk_…"

Importer une vidéo

L’import se fait en trois étapes : créer l’import, envoyer le fichier, puis signaler à Pellio que l’envoi est terminé.

1. Créez l’import. La réponse contient la vidéo et un objet upload avec une url, une method (PUT) et des headers. L’URL est valable 6 heures.

   curl https://api.pellio.io/v1/videos/uploads 
     -H "Authorization: Bearer pk_…" 
     -H "Content-Type: application/json" 
     -d '{"title":"Onboarding","filename":"onboarding.mp4","size":48213377,"type":"video/mp4"}'

2. Envoyez le fichier à upload.url avec PUT et les en-têtes fournis. Il part directement vers le stockage.
3. Appelez POST /v1/videos/{id}/complete. Le traitement démarre alors ; sans cette étape, il ne démarre jamais. L’événement video.ready, envoyé par webhook, vous prévient lorsqu’il est terminé.

Les fichiers doivent être des vidéos ou de l’audio, jusqu’à 20 GB. Pour les gros fichiers, utilisez un envoi avec reprise en parties de 16 MB : POST /v1/videos/{id}/multipart, puis /multipart/resume pour voir quelles parties sont arrivées, et /multipart/complete.

Pour importer à partir d’un lien, utilisez plutôt POST /v1/videos/import avec l’URL du fichier.

Référence

Tous les endpoints, avec les schémas de requête et de réponse et une console interactive, sont décrits dans la référence de l’API. Le document OpenAPI se trouve à l’adresse https://api.pellio.io/v1/openapi.json.

Limites de requêtes

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.