Filmsquare AiutoDocumentazione

Collega i tuoi strumenti

Come ricevo un webhook quando un ciak è pronto?

Aggiornato il .md

In questa pagina
  1. Iscriviti
  2. Eventi
  3. Controlla e rispondi

Un webhook manda un evento al tuo URL quando un ciak finisce, un ciak viene scelto o arriva una nuova versione, così non devi interrogare di continuo. I webhook si impostano tramite l'API da un produttore o un proprietario. Nello studio non c'è nessuna schermata per loro.

Iscriviti #

Manda una POST a /v1/workspaces/{ws}/webhooks con il tuo url e gli events che vuoi, oppure ["*"] per tutti. La risposta contiene un secret una sola volta: conservalo, perché ti serve per controllare ogni consegna. L'URL deve essere un indirizzo http o https su un host pubblico. Ti serve una chiave: vedi come ottenere una chiave API. La richiesta è nella documentazione sotto iscriviti.

Eventi #

Esistono quattro eventi: generation.succeeded, generation.failed, take.selected e asset_version.created. Gli eventi sui ciak nello sketchbook privato di una persona non vengono mai inviati. I campi di ciascuno sono in i dati di ogni evento.

Controlla e rispondi #

Ogni consegna porta un header x-fs-signature: sha256= più l'HMAC-SHA256 in esadecimale del corpo grezzo, con il tuo secret come chiave. Rifiuta una consegna la cui firma non corrisponde; il codice è in controllare la firma.

Rispondi con qualsiasi stato 2xx, in fretta. Un 5xx, un 429, un timeout o un errore di rete viene ritentato con backoff, fino a 8 tentativi. Qualsiasi altro 4xx chiude la consegna. Una consegna può arrivare più di una volta, quindi usa x-fs-delivery per saltare un evento che hai già gestito.

Scrivici