Téléchargements de vidéos API
Le téléchargement de vidéos API permet d’uploader directement des fichiers vidéo et de surveiller leur statut de traitement.
Tous les téléchargements sont traités asynchronement. Vous recevrez une réponse immédiate 202 Accepté et la vidéo sera traitée en arrière-plan. Vous devriez utiliser les points de terminaison de statut pour surveiller le progrès.
Télécharger une Vidéo
Ce point de terminaison accepte une requête multipart/form-data pour télécharger un nouveau fichier vidéo.
POST /téléchargements
Corps de la Requête (multipart/form-data)
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
video | fichier | Oui | Le fichier vidéo à télécharger. |
dossier | chaîne | Oui | La voie de collection où la vidéo devrait être placée (par exemple, root/my-dossier). |
Exemple de Requête (.http)
POST /api/client/v1/téléchargements
Authorization: Bearer sk-votre-api-clé-ici
Content-Type: multipart/form-data; boundary=...
... (données de formulaire avec fichier et dossier) ...Réponse : 202 Accepté
La API reconnaît le téléchargement et retourne le statut initial. Vous devriez stocker l’id pour vérifier le statut plus tard.
{
"message": "Téléchargement accepté et est maintenant en cours de traitement.",
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"status": 1,
"status_text": "pendant"
}
}Récupérer le Statut de Téléchargement
Récupère le statut des 50 téléchargements les plus récents. Vous pouvez poller ce point de terminaison pour mettre à jour votre interface utilisateur.
GET /téléchargements
Exemple de Requête
GET /api/client/v1/téléchargements
Authorization: Bearer sk-votre-api-clé-iciRéponse : 200 OK
{
"data": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "ma_nouvelle_vide.mp4",
"status": 3,
"status_text": "traitement",
"created_at": "2024-08-11T10:00:00Z",
"updated_at": "2024-08-11T10:01:00Z"
},
{
"id": "9c1fa5c3-b9f2-5c3f-8e7f-2d9b1c4e1f8e",
"filename": "ma_vide_précédente.mp4",
"status": 6,
"status_text": "terminé",
"created_at": "2024-08-10T15:00:00Z",
"updated_at": "2024-08-10T15:05:00Z"
}
]
}Récupérer le Statut d’un Téléchargement Unique
Récupère le statut d’une vidéo spécifique par son ID.
GET /téléchargements/{videoId}
Exemple de Requête
GET /api/client/v1/téléchargements/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fRéponse : 200 OK
{
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "ma_nouvelle_vide.mp4",
"status": 6,
"status_text": "terminé"
}
}Référence du Statut
| Code de statut | Texte de statut | Description |
|---|---|---|
1 | pendant | Le téléchargement est en file d’attente et attend d’être traité. |
3 | traitement | La vidéo est actuellement transcrite. |
5 | téléchargement | Les fichiers transcrites sont téléchargés vers le stockage final. |
6 | terminé | La vidéo est complètement traitée et prête à la lecture. |
7 | échoué | Une erreur s’est produite pendant le traitement. |