# Webhook'lara Genel Bakış

Webhook'lar, farklı uygulamaların senkronize çalışabilmesi için uygulama içinde oluşan olayları entegre olmuş diğer uygulamalara bildiren bir teknolojidir. Mağazanızda belirli olaylar gerçekleştiğinde Ideasoft, API çağrısı yapmanıza gerek kalmadan kayıtlı adresinize HTTP POST bildirimi gönderir.

:::warning{title="Yalnızca değişen alanlar gönderilir"}
Webhook gövdelerinde yalnızca değeri değişen alanlar gönderilir. Farklı verilere ihtiyacınız varsa bildirilen `id` ile ilgili API'ye istek atmanız gerekir.
:::

## Webhook kayıt özellikleri

Bir webhook kaydı aşağıdaki özelliklerden oluşur:

- `topic`: Webhook'u tetikleyen olay.
- `address`: Olay gerçekleştiğinde POST isteği gönderilen hedef URL.
- `status`: Webhook durumu.
- `created_at`: Webhook kaydının oluşturulma tarihi.
- `updated_at`: Webhook kaydının güncellenme tarihi.

:::info{title="fields"}
`fields` özelliği (istekte hangi alanların dönmesini istediğiniz) **V8'de kaldırılmıştır**.
:::

## Desteklenen olaylar

15 varlık için `create`, `update` ve `delete` olayları tanımlıdır (bazı varlıklarda olay alt kümesi):

| Varlık | Topik'ler |
|---|---|
| Marka (`brand`) | `brand/create`, `brand/update`, `brand/delete` |
| Kategori (`category`) | `category/create`, `category/update`, `category/delete` |
| Abonelik Sözleşmesi (`contract`) | `contract/create`, `contract/update`, `contract/delete` |
| Ekstra Ayarlar (`extra_pref`) | `extra_pref/update` |
| Üye (`member`) | `member/create`, `member/update`, `member/delete` |
| Üye Grubu (`member_group`) | `member_group/create`, `member_group/update`, `member_group/delete` |
| Sipariş (`order`) | `order/create`, `order/update`, `order/delete` |
| Sipariş İade Talebi (`order_refund_request`) | `order_refund_request/create`, `order_refund_request/update`, `order_refund_request/delete` |
| Ürün (`product`) | `product/create`, `product/update`, `product/delete` |
| Ödeme (`payment`) | `payment/create`, `payment/update`, `payment/delete` |
| Tema (`theme`) | `theme/create`, `theme/update`, `theme/delete` |
| Kuyruk İşlemi (`queue_process`) | `queue_process/create`, `queue_process/update` |
| Mail Listesi (`maillist`) | `maillist/create`, `maillist/update`, `maillist/delete` |
| Para Birimi (`currency`) | `currency/update` |
| Fiyat Kuralı (`price_rule`) | `price_rule/create`, `price_rule/update`, `price_rule/delete` |

Her topik `varlık/olay` biçimindedir; örneğin `order/create` veya `product/update`.

:::info{title="Alan listeleri"}
Her topik'in taşıdığı alanların güncel listesi için [Webhook Referansı](/webhooks/reference) sayfasına bakın.
:::

## İstek zarfı

Gövde her zaman aynı zarf formatındadır:

```json
{
  "order/create": { "id": 1, "status": "..." },
  "domain": "magaza-adiniz.myideasoft.com",
  "subDomain": "magaza-adiniz"
}
```

`delete` topiklerinde gövde çoğunlukla yalnızca `id` içerir (birkaç konuda ek alanlar bulunur).

Devamı: [Webhook Yönetimi](/webhooks/managing) · [Güvenlik](/webhooks/security) · [Teslimat](/webhooks/delivery)
