Substituir um vídeo

Para substituir um ficheiro de vídeo, envia um pedido PUT para o endpoint /videos/upload/[VIDEO_ID]. Vais receber uma resposta com um URL S3 assinado para carregares o ficheiro de vídeo.

Ao substituíres um vídeo, todos os ficheiros de vídeo antigos deste vídeo serão eliminados ou sobrescritos. A substituição é irreversível.

Obter URL assinado

CURL


curl -X PUT https://app.ignitevideo.cloud/api/videos/upload/[VIDEO_ID] \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \

JavaScript / Node.js


const response = await fetch(`https://app.ignitevideo.cloud/api/videos/upload/[VIDEO_ID]`, {
method: 'PUT',
headers: {
  'Authorization': `Bearer YOUR_TOKEN`,
  'Content-Type': 'application/json'
}
});

PHP


$client = new GuzzleHttp\Client();
$response = $client->request('PUT', 'https://app.ignitevideo.cloud/api/videos/upload/[VIDEO_ID]', [
'headers' => [
  'Authorization' => 'Bearer YOUR_TOKEN',
  'Content-Type' => 'application/json'
]
]);

Resposta


{
  "videoId": "[VIDEO_ID]",
  "signedUrl": "[SIGNED_URL]",
}

Carregar ficheiro de vídeo

Carrega o teu ficheiro de vídeo com um pedido PUT para o URL assinado devolvido no passo anterior. Tens de enviar o tipo MIME do ficheiro no cabeçalho Content-Type. Podes obter o tipo MIME a partir do ficheiro de vídeo local através do elemento de input de ficheiro.

CURL


curl -X PUT [SIGNED_URL] \
  -H "Content-Type: [MIME_TYPE]" \
  --data-binary "@[PATH_TO_VIDEO_FILE]"

JavaScript / Node.js


const response = await fetch([SIGNED_URL], {
  method: 'PUT',
  body: [VIDEO_FILE],
  headers: {
    'Content-Type': [MIME_TYPE]
  }
});

PHP


$client = new GuzzleHttp\Client();
$response = $client->request('PUT', [SIGNED_URL], [
  'body' => [VIDEO_FILE],
  'headers' => [
    'Content-Type' => [MIME_TYPE]
  ]
]);

Processo de codificação

Depois de o ficheiro de substituição ter sido carregado, inicia-se a codificação. Durante o fluxo de substituição, status pode ser brevemente REPLACING antes de passar a PROGRESSING. A codificação pode demorar algum tempo, consoante o tamanho do vídeo e a complexidade da codificação.

Consulta o estado da codificação com GET /api/videos/[VIDEO_ID], conforme descrito em obter vídeo. Um intervalo de polling de alguns segundos costuma ser suficiente. Enquanto a codificação decorre, status é PROGRESSING e statusProgress é uma percentagem de 0 a 100.

Exemplo de campos durante a codificação:


{
  "id": "[VIDEO_ID]",
  "status": "PROGRESSING",
  "statusProgress": 36,
  "errorCode": null,
  "errorMessage": null
}

Quando a codificação tem sucesso, status passa a COMPLETE, statusProgress é 100, e as fontes de reprodução ficam disponíveis em src.

Quando a codificação falha, status passa a ERROR. Usa errorCode para tratamento programático e errorMessage como alternativa legível. Consulta Estado de codificação para o ciclo de vida completo, os valores de estado e os códigos de erro.

Também podes subscrever webhooks video.updated em vez de fazer polling. As atualizações de progresso podem disparar-se com frequência durante a codificação. Consulta Webhooks.