Webhooks · In the sandbox

List webhooks

GET/api/v1/webhooklar/

Your webhooks (without secrets) and the valid categories.

Authentication

X-API-Keyheaderrequired
ulk_…
X-API-Secretheaderrequired
ulsk_…

Authentication →

Response fields

200 Webhooks. application/json

adetintegerrequired
kategorilerstring[]required
Values: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi
webhooklarWebhook[]required
- idintegerrequired
- urlstring (uri)required
- aktifbooleanrequired
- kategorilerstring[]required
  Empty = all categories. Values: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi
- tum_kategorilerbooleanrequired
- olusturmastring (date-time)requirednullable
- son_gonderimstring (date-time)requirednullable
- son_durumstringrequirednullable
- ardisik_hataintegerrequired
  Consecutive failures; paused at 20.
- son_teslimlerTeslim[]optional
  Only in webhook detail (last 20).
  teslim_idstringrequired
  Same across retries (de-duplication).
  olaystringrequired
  Values: sirket.degisiklik, test
  testbooleanrequired
  kategorilerstring[]required
  Values: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi
  durumstringrequired
  Values: bekliyor, basarili, hata, vazgecildi
  deneme_sayisiintegerrequired
  http_koduintegerrequirednullable
  hatastringrequirednullable
  olusturmastring (date-time)requirednullable
  son_denemestring (date-time)requirednullable

Error responses

401Missing or invalid key (yetkisiz).
429Hourly rate limit exceeded (hiz_siniri); the Retry-After header gives the seconds until reset.
500Unexpected error (ic_hata, taraf ulawk); retry shortly.

Error responses → hata, detay, hata_ayrinti

import requests basliklar = {"X-API-Key": "ulk_DENEME_ANAHTARINIZ", "X-API-Secret": "ulsk_DENEME_GIZLI_ANAHTARINIZ"} yanit = requests.get("https://ulawk.com/api/v1/webhooklar/", headers=basliklar, timeout=30) veri = yanit.json() if not yanit.ok: # hata_ayrinti.tekrar_denenebilir ise Retry-After kadar bekleyip yeniden deneyin print(yanit.status_code, veri["hata_ayrinti"]) print(veri)

const yanit = await fetch("https://ulawk.com/api/v1/webhooklar/", { method: "GET", headers: { "X-API-Key": "ulk_DENEME_ANAHTARINIZ", "X-API-Secret": "ulsk_DENEME_GIZLI_ANAHTARINIZ" } }); const veri = await yanit.json(); if (!yanit.ok) console.error(yanit.status, veri.hata_ayrinti); console.log(veri);

<?php $ch = curl_init("https://ulawk.com/api/v1/webhooklar/"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["X-API-Key: ulk_DENEME_ANAHTARINIZ", "X-API-Secret: ulsk_DENEME_GIZLI_ANAHTARINIZ"], ]); $govde = curl_exec($ch); $kod = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $veri = json_decode($govde, true); var_dump($kod, $veri);

using var http = new HttpClient(); http.DefaultRequestHeaders.Add("X-API-Key", "ulk_DENEME_ANAHTARINIZ"); http.DefaultRequestHeaders.Add("X-API-Secret", "ulsk_DENEME_GIZLI_ANAHTARINIZ"); var istek = new HttpRequestMessage(new HttpMethod("GET"), "https://ulawk.com/api/v1/webhooklar/"); var yanit = await http.SendAsync(istek); var metin = await yanit.Content.ReadAsStringAsync(); Console.WriteLine($"{(int)yanit.StatusCode} {metin}");

{ "adet": 1, "kategoriler": [ "durum", "adres" ], "webhooklar": [ { "id": 1, "url": "https://sisteminiz.ornek.com/ulawk", "aktif": true, "kategoriler": [ "durum", "yetkililer" ], "tum_kategoriler": false, "olusturma": "2026-10-16T00:00:00+00:00", "son_gonderim": "2026-10-16T00:00:00+00:00", "son_durum": "başarılı (HTTP 200)", "ardisik_hata": 0 } ] }

{ "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 } }

Retry-After: 73 { "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": 73 } }

Retry-After: 60 { "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 } }

List webhooks

#Authentication

#Response fields

#Error responses

Authentication

Response fields

Error responses