İçeriğe geç
Geliştirici

Webhook'lar · Deneme ortamında

Webhook ekle

POST/api/v1/webhooklar/

Yeni değişiklik webhook'u. Yalnız https; özel ya da yerel ağa çözülen adresler reddedilir. En çok 5 adres. kategoriler boşsa tüm kategoriler. Yanıttaki gizli imza anahtarı yalnız bu yanıtta gösterilir. Yalnız API anahtarıyla (oturum çerezi kabul edilmez).

Kimlik doğrulama

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

Kimlik doğrulama →

İstek gövdesi application/json

  • urlstring (uri)zorunlu
    https adresi (en çok 500 karakter).
  • kategorilerstring[]isteğe bağlı
    Abone olunan kategoriler. Değerler: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi

Yanıt alanları

201 Webhook ve gizli anahtar. application/json

  • 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
  • gizlistringzorunlu
    İmza anahtarı (whsec_…): YALNIZ bu yanıtta gösterilir.
  • aciklamastringzorunlu

Hata yanıtları

  • 400gecersiz_json ya da gecersiz_webhook (adres, kategori, sınır).
  • 403API anahtarı gerekli (anahtar_gerekli).
  • 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

Markdown · OpenAPI · llms.txt · © 2026 Ulawk