Caricamento di Video API
Il caricamento dei Video API consente di caricare file video direttamente e monitorare lo stato di elaborazione.
Tutti i caricamenti vengono elaborati in modo asincrono. Riceverete una risposta immediata 202 Accettato e il video verrà elaborato in background. Utilizzare gli endpoint dello stato per monitorare il progresso.
Carica un Video
Questo endpoint accetta richieste multipart/form-data per caricare un nuovo file video.
POST /caricamenti
Corpo della Richiesta (multipart/form-data)
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
video | file | Sì | Il file video da caricare. |
cartella | string | Sì | La cartella di destinazione dove il video dovrebbe essere posizionato (ad esempio, root/mia-cartella). |
Esempio di Richiesta (.http)
POST /api/client/v1/caricamenti
Autenticazione: Bearer sk-tuo-api-chiave-ecco
Content-Type: multipart/form-data; boundary=...
... (dati di form con file e cartella) ...Risposta: 202 Accettato
La API conferma il caricamento e restituisce lo stato iniziale. Salvare l’id per controllare lo stato successivamente.
{
"messaggio": "Caricamento accettato ed è ora in fase di elaborazione.",
"dati": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"stato": 1,
"testo_stato": "in sospeso"
}
}Ottieni lo Stato dei Caricamenti
Recupera lo stato degli ultimi 50 caricamenti. Puoi utilizzare questo endpoint per aggiornare la tua interfaccia utente.
GET /caricamenti
Esempio di Richiesta
GET /api/client/v1/caricamenti
Autenticazione: Bearer sk-tuo-api-chiave-eccoRisposta: 200 OK
{
"dati": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"nome_file": "mio_nuovo_video.mp4",
"stato": 3,
"testo_stato": "in elaborazione",
"creato_il": "2024-08-11T10:00:00Z",
"aggiornato_il": "2024-08-11T10:01:00Z"
},
{
"id": "9c1fa5c3-b9f2-5c3f-8e7f-2d9b1c4e1f8e",
"nome_file": "mio_precedente_video.mp4",
"stato": 6,
"testo_stato": "completato",
"creato_il": "2024-08-10T15:00:00Z",
"aggiornato_il": "2024-08-10T15:05:00Z"
}
]
}Ottieni lo Stato di un Caricamento Singolo
Recupera lo stato di un video specifico tramite il suo ID.
GET /caricamenti/{videoId}
Esempio di Richiesta
GET /api/client/v1/caricamenti/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fRisposta: 200 OK
{
"dati": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"nome_file": "mio_nuovo_video.mp4",
"stato": 6,
"testo_stato": "completato"
}
}Riferimento allo Stato
| Codice di Stato | Testo dello Stato | Descrizione |
|---|---|---|
1 | in sospeso | Il caricamento è in coda e attende di essere elaborato. |
3 | in elaborazione | Il video è attualmente in fase di trascodifica. |
5 | caricamento | I file trascodificati vengono caricati nella memoria finale. |
6 | completato | Il video è completamente elaborato e pronto per la riproduzione. |
7 | fallito | Si è verificato un errore durante l’elaborazione. |