Sostituire un video

Per sostituire un file video invii una richiesta PUT all’endpoint /videos/upload/[VIDEO_ID]. Riceverai una risposta contenente un URL S3 firmato per caricare il file video.

Quando sostituisci un video, tutti i vecchi file video di quel video vengono eliminati o sovrascritti. La sostituzione è irreversibile.

Ottenere l’URL firmato

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'
]
]);

Risposta


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

Caricare il file video

Carica il file video con una richiesta PUT all’URL firmato restituito nel passaggio precedente. Devi passare il tipo MIME del file nell’header Content-Type. Puoi ricavare il tipo MIME dal file video locale tramite l’elemento input file.

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 di codifica

Dopo il caricamento del file sostitutivo, inizia la codifica. Durante il flusso di sostituzione, status può essere brevemente REPLACING prima di diventare PROGRESSING. Questo processo può richiedere del tempo, a seconda della dimensione del video e della complessità della codifica.

Interroga lo stato di codifica con GET /api/videos/[VIDEO_ID] come descritto in ottenere video. Un intervallo di polling di pochi secondi di solito è sufficiente. Mentre la codifica è in corso, status è PROGRESSING e statusProgress è una percentuale da 0 a 100.

Esempio di campi durante la codifica:


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

Quando la codifica ha successo, status diventa COMPLETE, statusProgress è 100 e le sorgenti di riproduzione sono disponibili in src.

Quando la codifica fallisce, status diventa ERROR. Usa errorCode per la gestione programmatica e errorMessage come fallback leggibile. Vedi Stato di codifica per il ciclo di vita completo, i valori di stato e i codici di errore.

Puoi anche iscriverti ai webhook video.updated invece di fare polling. Gli aggiornamenti di progresso possono scattare spesso durante la codifica. Vedi Webhooks.