İçeriğe geç
Geliştirici

İlanlar ve gazeteler · Deneme ortamında

Şirketin ilanları

GET/api/v1/sirketler/{sirket_id}/ilanlar/

Şirketin Ticaret Sicili Gazetesi ilanları (en yeni önce): tarih, tür, sayı/sayfa, sade dilde başlık ve açıklama, gazete PDF bağlantısı ve değişiklik kategorisi.

Kimlik doğrulama

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

Kimlik doğrulama →

Yol parametreleri

  • sirket_idinteger | stringzorunlu
    Şirket kimliği (/api/v1/sirketler/ listesindeki id).

Sorgu parametreleri

  • kategoristringisteğe bağlı
    Virgülle ilan türü kategorisi (eski süzgeç): kurulus, konkordato, birlesme, sermaye, ortaklik, yonetim, unvan_adres, genel_kurul, esas, diger.
  • kategorilerstringisteğe bağlı
    Virgülle değişiklik kategorisi süzgeci: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi. Bilinmeyen kategori 400 gecersiz_kategori.

Yanıt alanları

200 İlanlar. application/json

  • sirketSirketOzetzorunlu
    • idinteger | stringzorunlu
      Şirket kimliği: gerçek anahtarda sayısal (ör. 1234); deneme anahtarında DENEME-… metni.
    • unvanstringzorunlunull olabilir
      Ticaret unvanı.
    • mudurlukstringzorunlunull olabilir
      Sicil müdürlüğü (ör. İSTANBUL).
    • sicil_nostringzorunlunull olabilir
      Ticaret sicil numarası.
  • adetintegerzorunlu
  • ilanlarIlan[]zorunlu
    • ilan_idintegerzorunlu
    • tarihstring (date)zorunlu
    • turstringzorunlu
      İlan türü.
    • kategoristringzorunlu
      İlan türü kategorisi (eski süzgeç kategori=). Değerler: kurulus, konkordato, birlesme, sermaye, ortaklik, yonetim, unvan_adres, genel_kurul, esas, diger
    • kategori_adstringzorunlu
    • sicil_nostringzorunlunull olabilir
    • sayistringzorunlunull olabilir
      Gazete sayısı.
    • sayfastringzorunlunull olabilir
      Gazete sayfası.
    • baslikstringzorunlunull olabilir
      Sade dilde başlık.
    • aciklamastringzorunlunull olabilir
    • kaynakKaynakzorunlunull olabilir
      • ilan_idintegerzorunlu
        Bilginin geçtiği ilan.
      • ilan_tarihistring (date)zorunlu
        İlanın yayım tarihi.
      • ilan_turustringzorunlu
        Ticaret Sicili Gazetesi ilan türü.
      • alintistringzorunlu
        İlan metninden birebir alıntı.
      • alinti_dogrulandibooleanzorunlu
        Alıntı ilan metninde birebir bulundu mu.
      • gazete_pdfstring (uri)zorunlu
        Gazete PDF'i.
      • vurguVurguzorunlunull olabilir
        • sayfaintegerzorunlu
          Gazete sayfası (1'den).
        • sayfa_gorselstring (uri)zorunlu
          Sayfanın PNG görseli.
        • kutularnumber[][]zorunlu
          Bilginin sayfadaki yeri: oransal [x0, y0, x1, y1] kutuları (0–1, sol üst köşe).
        • kutu_birimistringzorunlu
          Kutu biriminin açıklaması.
    • gazete_pdfstring (uri)zorunlunull olabilir
      Arşivdeyse gazete PDF'i.
    • gazete_arsivdebooleanzorunlu
    • degisiklik_kategorisistringzorunlu
      Değerler: durum, adres, ortaklik, sermaye, yetkililer, unvan, esas_sozlesme, diger, kapandi

Hata yanıtları

  • 400Geçersiz parametre (gecersiz_parametre, gecersiz_kategori, gecersiz_tarih…) ya da bu uç deneme anahtarıyla kullanılamaz (deneme_desteklenmiyor).
  • 404Bulunamadı ya da erişim yetkiniz yok (bulunamadi).
  • 503Resmî kaynak şu an erişilemiyor (kaynak_erisilemiyor, taraf kaynak). Deneme ortamında DENEME-KAYNAK-KAPALI.
  • 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