Filmsquare YardımDokümanlar

Araçlarını bağla

Bir çekim hazır olduğunda nasıl webhook alırım?

Güncellendi .md

Bu sayfada
  1. Abone ol
  2. Olaylar
  3. Kontrol et ve yanıtla

Bir webhook, bir çekim bittiğinde, bir çekim seçildiğinde ya da yeni bir versiyon geldiğinde URL'ne bir olay gönderir; böylece yoklamak zorunda kalmazsın. Webhook'lar bir yapımcı ya da sahip tarafından API üzerinden kurulur. Stüdyoda bunlar için bir ekran yok.

Abone ol #

/v1/workspaces/{ws}/webhooks adresine url'n ve istediğin events ile ya da hepsi için ["*"] ile bir POST gönder. Yanıt bir secret'ı bir kez içerir: sakla, çünkü her teslimatı kontrol etmek için ona ihtiyacın var. URL, herkese açık bir ana makinede bir http ya da https adresi olmalı. Bir anahtara ihtiyacın var: bkz. API anahtarı nasıl alınır. İstek dokümanlarda abone ol altında.

Olaylar #

Dört olay var: generation.succeeded, generation.failed, take.selected ve asset_version.created. Bir kişinin özel eskiz defterindeki çekimlerle ilgili olaylar hiçbir zaman gönderilmez. Her birinin alanları her olayın verisi bölümünde.

Kontrol et ve yanıtla #

Her teslimat bir x-fs-signature başlığı taşır: sha256= artı ham gövdenin, gizli anahtarınla anahtarlanmış onaltılık HMAC-SHA256'sı. İmzası uyuşmayan bir teslimatı reddet; kod imzayı kontrol et bölümünde.

Herhangi bir 2xx durumuyla, hızlıca yanıtla. Bir 5xx, bir 429, bir zaman aşımı ya da bir ağ hatası, geri çekilmeyle, en fazla 8 denemeye kadar yeniden denenir. Diğer her 4xx teslimatı bitirir. Bir teslimat birden fazla kez gelebilir; bu yüzden zaten ele aldığın bir olayı atlamak için x-fs-delivery kullan.

Bize e-posta yaz