# Test bildirimi gönder

`POST https://ulawk.com/api/v1/webhooklar/{webhook_id}/test/`

Uydurma DENEME şirketiyle tek test bildirimi gönderir (gövdede `"test": true`) ve sonucu hemen döndürür; yeniden denenmez. Adresiniz 2xx dönmezse 502 `webhook_teslim_hatasi`.

## Kimlik doğrulama

Her istekte iki başlık: `X-API-Key` ve `X-API-Secret`.

## Yol parametreleri

- `webhook_id` (integer, zorunlu) — Webhook kimliği.

## Yanıt

### 200 — Teslim edildi.

- `teslim` (Teslim, zorunlu)
- `teslim.teslim_id` (string, zorunlu) — Yeniden denemelerde aynı (mükerrer ayıklama).
- `teslim.olay` (string, zorunlu) Değerler: sirket.degisiklik, test.
- `teslim.test` (boolean, zorunlu)
- `teslim.kategoriler[]` (string[], zorunlu)
- `teslim.durum` (string, zorunlu) Değerler: bekliyor, basarili, hata, vazgecildi.
- `teslim.deneme_sayisi` (integer, zorunlu)
- `teslim.http_kodu` (integer, null, zorunlu)
- `teslim.hata` (string, null, zorunlu)
- `teslim.olusturma` (string (date-time), null, zorunlu)
- `teslim.son_deneme` (string (date-time), null, zorunlu)

```json
{
  "teslim": {
    "teslim_id": "msg_3f9c1a0b7d2e4c5f6a7b8c9d",
    "olay": "test",
    "test": true,
    "kategoriler": [
      "durum",
      "yetkililer"
    ],
    "durum": "basarili",
    "deneme_sayisi": 1,
    "http_kodu": 200,
    "hata": null,
    "olusturma": "2026-10-16T00:00:00+00:00",
    "son_deneme": "2026-10-16T00:00:00+00:00"
  }
}
```

### 403 — `anahtar_gerekli`.


```json
{
  "hata": "anahtar_gerekli",
  "detay": "Bu işlem için X-API-Key (ve X-API-Secret) başlığı gerekli; panelden de yapabilirsiniz.",
  "hata_ayrinti": {
    "kod": "anahtar_gerekli",
    "mesaj": "Bu işlem için X-API-Key (ve X-API-Secret) başlığı gerekli; panelden de yapabilirsiniz.",
    "taraf": "istemci",
    "kaynak": null,
    "tekrar_denenebilir": false,
    "tekrar_sn": null
  }
}
```

### 404 — Bulunamadı ya da erişim yetkiniz yok (`bulunamadi`).


```json
{
  "hata": "bulunamadi",
  "detay": "Şirket bulunamadı ya da erişim yetkiniz yok.",
  "hata_ayrinti": {
    "kod": "bulunamadi",
    "mesaj": "Şirket bulunamadı ya da erişim yetkiniz yok.",
    "taraf": "istemci",
    "kaynak": null,
    "tekrar_denenebilir": false,
    "tekrar_sn": null
  }
}
```

### 502 — Adresiniz 2xx dönmedi; `teslim` ayrıntıyı taşır.

Retry-After: `60`

```json
{
  "hata": "webhook_teslim_hatasi",
  "detay": "Test bildirimi teslim edilemedi: HTTP 500",
  "hata_ayrinti": {
    "kod": "webhook_teslim_hatasi",
    "mesaj": "Test bildirimi teslim edilemedi: HTTP 500",
    "taraf": "istemci",
    "kaynak": null,
    "tekrar_denenebilir": true,
    "tekrar_sn": 60
  },
  "teslim": {
    "teslim_id": "msg_3f9c1a0b7d2e4c5f6a7b8c9d",
    "olay": "test",
    "test": true,
    "kategoriler": [
      "durum",
      "yetkililer"
    ],
    "durum": "vazgecildi",
    "deneme_sayisi": 1,
    "http_kodu": 500,
    "hata": "HTTP 500",
    "olusturma": "2026-10-16T00:00:00+00:00",
    "son_deneme": "2026-10-16T00:00:00+00:00"
  }
}
```

### 401 — Anahtar yok ya da geçersiz (`yetkisiz`).


```json
{
  "hata": "yetkisiz",
  "detay": "Geçerli X-API-Key başlığı gerekli (panel › API).",
  "hata_ayrinti": {
    "kod": "yetkisiz",
    "mesaj": "Geçerli X-API-Key başlığı gerekli (panel › API).",
    "taraf": "istemci",
    "kaynak": null,
    "tekrar_denenebilir": false,
    "tekrar_sn": null
  }
}
```

### 429 — Saatlik istek sınırı aşıldı (`hiz_siniri`); Retry-After başlığı sıfırlanmaya kalan saniyeyi verir.

Retry-After: `3172`

```json
{
  "hata": "hiz_siniri",
  "detay": "Saatlik istek sınırı aşıldı (600). Bir sonraki saatte tekrar deneyin.",
  "hata_ayrinti": {
    "kod": "hiz_siniri",
    "mesaj": "Saatlik istek sınırı aşıldı (600). Bir sonraki saatte tekrar deneyin.",
    "taraf": "istemci",
    "kaynak": null,
    "tekrar_denenebilir": true,
    "tekrar_sn": 3172
  }
}
```

### 500 — Beklenmeyen hata (`ic_hata`, taraf ulawk); kısa süre sonra yeniden deneyin.

Retry-After: `60`

```json
{
  "hata": "ic_hata",
  "detay": "Beklenmeyen bir hata oluştu; kısa süre sonra yeniden deneyin.",
  "hata_ayrinti": {
    "kod": "ic_hata",
    "mesaj": "Beklenmeyen bir hata oluştu; kısa süre sonra yeniden deneyin.",
    "taraf": "ulawk",
    "kaynak": null,
    "tekrar_denenebilir": true,
    "tekrar_sn": 60
  }
}
```

## İstek

```bash
curl -X POST "https://ulawk.com/api/v1/webhooklar/1/test/" \
  -H "X-API-Key: ulk_DENEME_ANAHTARINIZ" \
  -H "X-API-Secret: ulsk_DENEME_GIZLI_ANAHTARINIZ"
```