Webhook'lar · Deneme ortamında

Webhook'ları listele

GET/api/v1/webhooklar/

Webhook'larınız (gizli anahtar hariç) ve geçerli kategoriler.

Kimlik doğrulama

X-API-Keyheaderzorunlu
ulk_…
X-API-Secretheaderzorunlu
ulsk_…

Kimlik doğrulama →

Yanıt alanları

200 Webhook'lar. application/json

adetintegerzorunlu
kategorilerstring[]zorunlu
Değerler: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi
webhooklarWebhook[]zorunlu
- idintegerzorunlu
- urlstring (uri)zorunlu
- aktifbooleanzorunlu
- kategorilerstring[]zorunlu
  Boş = tüm kategoriler. Değerler: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi
- tum_kategorilerbooleanzorunlu
- olusturmastring (date-time)zorunlunull olabilir
- son_gonderimstring (date-time)zorunlunull olabilir
- son_durumstringzorunlunull olabilir
- ardisik_hataintegerzorunlu
  Art arda başarısız teslim; 20'de webhook durur.
- son_teslimlerTeslim[]isteğe bağlı
  Yalnız tek webhook ayrıntısında (son 20).
  teslim_idstringzorunlu
  Yeniden denemelerde aynı (mükerrer ayıklama).
  olaystringzorunlu
  Değerler: sirket.degisiklik, test
  testbooleanzorunlu
  kategorilerstring[]zorunlu
  Değerler: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi
  durumstringzorunlu
  Değerler: bekliyor, basarili, hata, vazgecildi
  deneme_sayisiintegerzorunlu
  http_koduintegerzorunlunull olabilir
  hatastringzorunlunull olabilir
  olusturmastring (date-time)zorunlunull olabilir
  son_denemestring (date-time)zorunlunull olabilir

Hata yanıtları

401Anahtar yok ya da geçersiz (yetkisiz).
429Saatlik istek sınırı aşıldı (hiz_siniri); Retry-After başlığı sıfırlanmaya kalan saniyeyi verir.
500Beklenmeyen hata (ic_hata, taraf ulawk); kısa süre sonra yeniden deneyin.

Hata yanıtları → 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 } }

Webhook'ları listele

#Kimlik doğrulama

#Yanıt alanları

#Hata yanıtları

Kimlik doğrulama

Yanıt alanları

Hata yanıtları