Uploads API
O Upload API permite a upload de arquivos de vídeo diretamente e monitorar o status de processamento.
Todas as uploads são processadas assincronamente. Você receberá uma resposta imediata 202 Aceito e o vídeo será processado em segundo plano. Você deve usar os endpoints de status para monitorar o progresso.
Uploade um Vídeo
Este endpoint aceita uma solicitação multipart/form-data para uploadar um novo arquivo de vídeo.
POST /uploads
Corpo da Solicitação (multipart/form-data)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
video | file | Sim | O arquivo de vídeo a ser uploadado. |
folder | string | Sim | A pasta onde o vídeo deve ser colocado (por exemplo, root/my-pasta). |
Exemplo de Solicitação (.http)
POST /api/client/v1/uploads
Authorization: Bearer sk-sua-api-chave-aqui
Content-Type: multipart/form-data; boundary=...
... (dados da forma com arquivo e pasta) ...Resposta: 202 Aceito
A API confirma a upload e retorna o status inicial. Você deve armazenar o id para verificar o status posteriormente.
{
"message": "Upload aceito e está sendo processado.",
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"status": 1,
"status_text": "pendente"
}
}Obtenha o Status de Upload
Recupera o status dos últimos 50 uploads. Você pode pollar este endpoint para atualizar sua UI.
GET /uploads
Exemplo de Solicitação
GET /api/client/v1/uploads
Authorization: Bearer sk-sua-api-chave-aquiResposta: 200 OK
{
"data": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "meu_novo_video.mp4",
"status": 3,
"status_text": "processando",
"created_at": "2024-08-11T10:00:00Z",
"updated_at": "2024-08-11T10:01:00Z"
},
{
"id": "9c1fa5c3-b9f2-5c3f-8e7f-2d9b1c4e1f8e",
"filename": "meu_video_anterior.mp4",
"status": 6,
"status_text": "concluído",
"created_at": "2024-08-10T15:00:00Z",
"updated_at": "2024-08-10T15:05:00Z"
}
]
}Obtenha o Status de Upload Individual
Recupera o status de um vídeo específico por seu ID.
GET /uploads/{videoId}
Exemplo de Solicitação
GET /api/client/v1/uploads/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fResposta: 200 OK
{
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "meu_novo_video.mp4",
"status": 6,
"status_text": "concluído"
}
}Referência de Status
| Código de Status | Texto do Status | Descrição |
|---|---|---|
1 | pendente | O upload está na fila e aguardando processamento. |
3 | processando | O vídeo está sendo transcodificado no momento. |
5 | uploadando | Os arquivos transcodificados estão sendo uploadados para armazenamento final. |
6 | concluído | O vídeo está completamente processado e pronto para reprodução. |
7 | falha | Ocorreu um erro durante o processamento. |