Bir çekim hazır olduğunda nasıl webhook alırım?
Bu sayfada
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.