Subidas de Video API
La subida de videos API proporciona una forma de subir archivos de video directamente y monitorear el estado de procesamiento.
Todas las subidas se procesan de manera asíncrona. Recibirá una respuesta inmediata 202 Aceptado y el video se procesará en segundo plano. Debe utilizar los puntos finales de estado para monitorear el progreso.
Subir un Video
Este punto final acepta solicitudes multipart/form-data para subir un nuevo archivo de video.
POST /subidas
Cuerpo de la solicitud (multipart/form-data)
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
video | archivo | Sí | El archivo de video a subir. |
carpeta | cadena | Sí | La ruta de la colección donde el video debe ser colocado (por ejemplo, raíz/mi-carpeta). |
Ejemplo de solicitud (.http)
POST /api/cliente/v1/subidas
Autorización: Bearer sk-tu-api-llave-aquí
Tipo de contenido: multipart/form-data; límite=...
... (datos del formulario con archivo y carpeta) ...Respuesta: 202 Aceptado
La API confirma la subida y devuelve el estado inicial. Debe almacenar el id para verificar el estado más tarde.
{
"mensaje": "La subida se ha aceptado y ahora está siendo procesada.",
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"estado": 1,
"texto_estado": "pendiente"
}
}Obtener el estado de subida
Recupera el estado de las últimas 50 subidas. Puede realizar una solicitud periódica para actualizar su interfaz de usuario.
GET /subidas
Ejemplo de solicitud
GET /api/cliente/v1/subidas
Autorización: Bearer sk-tu-api-llave-aquíRespuesta: 200 OK
{
"data": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"nombre_archivo": "mi_nuevo_video.mp4",
"estado": 3,
"texto_estado": "procesando",
"creado_en": "2024-08-11T10:00:00Z",
"actualizado_en": "2024-08-11T10:01:00Z"
},
{
"id": "9c1fa5c3-b9f2-5c3f-8e7f-2d9b1c4e1f8e",
"nombre_archivo": "mi_video_anterior.mp4",
"estado": 6,
"texto_estado": "completado",
"creado_en": "2024-08-10T15:00:00Z",
"actualizado_en": "2024-08-10T15:05:00Z"
}
]
}Obtener el estado de subida individual
Recupera el estado de un video específico por su ID.
GET /subidas/{videoId}
Ejemplo de solicitud
GET /api/cliente/v1/subidas/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fRespuesta: 200 OK
{
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"nombre_archivo": "mi_nuevo_video.mp4",
"estado": 6,
"texto_estado": "completado"
}
}Referencia de estado
| Código de Estado | Texto de Estado | Descripción |
|---|---|---|
1 | pendiente | La subida está en cola y espera ser procesada. |
3 | procesando | El video se está codificando actualmente. |
5 | subiendo | Los archivos codificados se están subiendo a almacenamiento final. |
6 | completado | El video está completamente procesado y listo para reproducción. |
7 | fallido | Ocurrió un error durante el procesamiento. |