---
title: "Bir çekim hazır olduğunda nasıl webhook alırım?"
description: "Bir yapımcı ya da sahip, API üzerinden bir URL'ye abone olur. Teslimatlar x-fs-signature ile imzalanır ve sunucun başarısız olursa yeniden denenir."
url: https://www.filmsquare.ai/help/tr/connect/webhooks/
lang: tr
section: connect
updated: 2026-11-13
---

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](https://www.filmsquare.ai/help/tr/connect/api-keys/). İstek dokümanlarda [abone ol](https://www.filmsquare.ai/docs/tr/api/webhooks/#subscribe) 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](https://www.filmsquare.ai/docs/tr/api/webhooks/#the-data-of-each-event) 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](https://www.filmsquare.ai/docs/tr/api/webhooks/#check-the-signature) 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.

> [!NOTE]
> Kendi Claude'un webhook'lara erişemez, çünkü onlar veriyi Filmsquare'in dışına gönderir.
