Come ricevo un webhook quando un ciak è pronto?
In questa pagina
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.