# Ulawk Geliştirici belgeleri

> Türkiye ticaret sicili şirket takibi API'si: kaynaklı profil, değişiklikler, ilanlar, gazete PDF'leri, webhook'lar, deneme ortamı ve MCP. Her sayfanın Markdown hali adresin sonuna .md eklenerek alınır.

- [OpenAPI 3.1](https://ulawk.com/gelistirici/openapi.json)

## Belgeler

- [Giriş](https://ulawk.com/gelistirici.md): Ulawk API: Türkiye ticaret sicilindeki şirketleri kaynaklı veriyle takip edin.
- [Kimlik doğrulama](https://ulawk.com/gelistirici/kimlik-dogrulama.md): X-API-Key ve X-API-Secret başlıkları; deneme ve gerçek anahtarlar.
- [Hızlı başlangıç](https://ulawk.com/gelistirici/hizli-baslangic.md): Şirket ekle → hazırlanmasını izle → profili oku → webhook'a abone ol.
- [Veri durumu ve boş liste kuralı](https://ulawk.com/gelistirici/veri-durumu.md): veri_durumu : her bölümün tamlığı, yöntemi ve sınırları.
- [Kaynak izi](https://ulawk.com/gelistirici/kaynak-izi.md): Her bilginin ilanı, birebir alıntısı ve gazete sayfasındaki yeri.
- [Doğrulama raporu ve imza kontrolü](https://ulawk.com/gelistirici/dogrulama-ve-imza.md): Mühürlü doğrulama raporu ve "bu imza geçerli mi?" kontrolü.
- [Hızlı sorgu ve form doldurma](https://ulawk.com/gelistirici/hizli-sorgu.md): Ulawk dizininden anında şirket adayı; sunucudan sunucuya form doldurma.
- [Değişiklik kategorileri](https://ulawk.com/gelistirici/degisiklik-kategorileri.md): Her değişiklik ve ilan sabit bir kategoriye düşer.
- [Webhook'lar](https://ulawk.com/gelistirici/webhooklar.md): Kategorili değişiklik bildirimleri, imza doğrulama, yeniden deneme.
- [Hız sınırları](https://ulawk.com/gelistirici/hiz-sinirlari.md): Anahtar başına saatte 600 istek; 429 ve Retry-After.
- [Hatalar](https://ulawk.com/gelistirici/hatalar.md): Tek hata modeli: hata, detay, hata_ayrinti.
- [Deneme ortamı ve test kimlikleri](https://ulawk.com/gelistirici/deneme-ortami.md): Uydurma DENEME-… şirketleriyle gerçek veriye dokunmadan deneyin.
- [MCP](https://ulawk.com/gelistirici/mcp.md): Yapay zekâ asistanlarından Ulawk araçları.
- [Sürüm politikası](https://ulawk.com/gelistirici/surum-politikasi.md): v1 yalnız eklemeyle büyür.

## Ülke rehberleri

- [Ülke rehberleri](https://ulawk.com/gelistirici/ulkeler.md): Ülke ülke kimlikler, veri noktaları, belgeler ve yenileme.
- [Türkiye](https://ulawk.com/gelistirici/ulkeler/tr.md): Türkiye: Tam kapsam · Türkiye Ticaret Sicili Gazetesi + KAP
- [ABD](https://ulawk.com/gelistirici/ulkeler/us.md): ABD: Tam kapsam · ABD sermaye piyasası bildirimleri ve eyalet şirket sicilleri
- [Kanada](https://ulawk.com/gelistirici/ulkeler/ca.md): Kanada: Sicil kaydı · Kanada resmî şirket sicili
- [Birleşik Krallık](https://ulawk.com/gelistirici/ulkeler/gb.md): Birleşik Krallık: Tam kapsam · İngiltere resmî şirket sicili ve resmî ilan gazetesi
- [Bulgaristan](https://ulawk.com/gelistirici/ulkeler/bg.md): Bulgaristan: Tam kapsam · Bulgaristan resmî şirket sicili
- [Çekya](https://ulawk.com/gelistirici/ulkeler/cz.md): Çekya: Tam kapsam · Çekya resmî şirket sicili
- [Estonya](https://ulawk.com/gelistirici/ulkeler/ee.md): Estonya: Tam kapsam · Estonya resmî şirket sicili
- [Letonya](https://ulawk.com/gelistirici/ulkeler/lv.md): Letonya: Tam kapsam · Letonya resmî şirket sicili
- [Norveç](https://ulawk.com/gelistirici/ulkeler/no.md): Norveç: Tam kapsam · Norveç resmî şirket sicili
- [Polonya](https://ulawk.com/gelistirici/ulkeler/pl.md): Polonya: Tam kapsam · Polonya resmî şirket sicili ve resmî gerçek faydalanıcı sicili
- [Slovakya](https://ulawk.com/gelistirici/ulkeler/sk.md): Slovakya: Tam kapsam · Slovakya resmî şirket sicili
- [Finlandiya](https://ulawk.com/gelistirici/ulkeler/fi.md): Finlandiya: Sicil kaydı · Finlandiya resmî şirket sicili ve resmî ilan gazetesi
- [Fransa](https://ulawk.com/gelistirici/ulkeler/fr.md): Fransa: Sicil kaydı · Fransa resmî şirket sicili ve resmî ilan gazetesi
- [Hırvatistan](https://ulawk.com/gelistirici/ulkeler/hr.md): Hırvatistan: Sicil kaydı · Hırvatistan resmî şirket sicili
- [İrlanda](https://ulawk.com/gelistirici/ulkeler/ie.md): İrlanda: Sicil kaydı · İrlanda resmî şirket sicili
- [İspanya](https://ulawk.com/gelistirici/ulkeler/es.md): İspanya: Sicil kaydı · İspanya resmî ilan gazetesi
- [İsveç](https://ulawk.com/gelistirici/ulkeler/se.md): İsveç: Sicil kaydı · İsveç resmî şirket sicili
- [İsviçre](https://ulawk.com/gelistirici/ulkeler/ch.md): İsviçre: Sicil kaydı · İsviçre resmî ilan gazetesi ve resmî şirket sicili
- [Kıbrıs](https://ulawk.com/gelistirici/ulkeler/cy.md): Kıbrıs: Sicil kaydı · Kıbrıs resmî şirket sicili
- [Litvanya](https://ulawk.com/gelistirici/ulkeler/lt.md): Litvanya: Sicil kaydı · Litvanya resmî şirket sicili
- [Lüksemburg](https://ulawk.com/gelistirici/ulkeler/lu.md): Lüksemburg: Sicil kaydı · Lüksemburg resmî finansal tablo kaydı ve uluslararası şirket kimlik kaydı (LEI)
- [Romanya](https://ulawk.com/gelistirici/ulkeler/ro.md): Romanya: Sicil kaydı · Romanya resmî vergi kaydı
- [Ukrayna](https://ulawk.com/gelistirici/ulkeler/ua.md): Ukrayna: Sicil kaydı · Ukrayna resmî şirket sicili
- [Avusturya](https://ulawk.com/gelistirici/ulkeler/at.md): Avusturya: LEI kaydı · Uluslararası şirket kimlik kaydı (LEI)
- [Hollanda](https://ulawk.com/gelistirici/ulkeler/nl.md): Hollanda: LEI kaydı · Uluslararası şirket kimlik kaydı (LEI)
- [İtalya](https://ulawk.com/gelistirici/ulkeler/it.md): İtalya: LEI kaydı · Uluslararası şirket kimlik kaydı (LEI)
- [Tayvan](https://ulawk.com/gelistirici/ulkeler/tw.md): Tayvan: Tam kapsam · Tayvan resmî şirket sicili
- [Japonya](https://ulawk.com/gelistirici/ulkeler/jp.md): Japonya: Sicil kaydı · Japonya resmî şirket kaydı
- [Singapur](https://ulawk.com/gelistirici/ulkeler/sg.md): Singapur: Sicil kaydı · Singapur resmî şirket sicili
- [Avustralya](https://ulawk.com/gelistirici/ulkeler/au.md): Avustralya: Temel kayıt · Avustralya resmî şirket sicili
- [Brezilya](https://ulawk.com/gelistirici/ulkeler/br.md): Brezilya: Sicil kaydı · Brezilya resmî şirket sicili
- [Guernsey](https://ulawk.com/gelistirici/ulkeler/gg.md): Guernsey: Sicil kaydı · Guernsey resmî şirket sicili
- [Jersey](https://ulawk.com/gelistirici/ulkeler/je.md): Jersey: Sicil kaydı · Jersey resmî şirket sicili
- [Lihtenştayn](https://ulawk.com/gelistirici/ulkeler/li.md): Lihtenştayn: Sicil kaydı · Lihtenştayn resmî şirket sicili
- [Man Adası](https://ulawk.com/gelistirici/ulkeler/im.md): Man Adası: Sicil kaydı · Man Adası resmî şirket sicili
- [Belize](https://ulawk.com/gelistirici/ulkeler/bz.md): Belize: Temel kayıt · Belize resmî şirket sicili
- [Curaçao](https://ulawk.com/gelistirici/ulkeler/cw.md): Curaçao: Temel kayıt · Curaçao resmî şirket sicili
- [Seyşeller](https://ulawk.com/gelistirici/ulkeler/sc.md): Seyşeller: Temel kayıt · Seyşeller resmî şirket sicili
- [Britanya Virjin Adaları](https://ulawk.com/gelistirici/ulkeler/vg.md): Britanya Virjin Adaları: LEI kaydı · Uluslararası şirket kimlik kaydı (LEI)
- [Cayman Adaları](https://ulawk.com/gelistirici/ulkeler/ky.md): Cayman Adaları: LEI kaydı · Uluslararası şirket kimlik kaydı (LEI)
- [Mauritius](https://ulawk.com/gelistirici/ulkeler/mu.md): Mauritius: LEI kaydı · Uluslararası şirket kimlik kaydı (LEI)
- [İsrail](https://ulawk.com/gelistirici/ulkeler/il.md): İsrail: Sicil kaydı · İsrail resmî şirket sicili

## API başvurusu

- [API başvurusu](https://ulawk.com/gelistirici/api.md): Ulawk API uçları.
- [Takip edilen şirketler](https://ulawk.com/gelistirici/api/sirketleri-listele.md): Takip ettiğiniz şirketler: kimlik, unvan, müdürlük, sicil no, ilan sayısı ve profil bağlantısı. Unvana göre sıralı ve sayfalıdır.
- [Şirketi takibe al](https://ulawk.com/gelistirici/api/sirket-ekle.md): Şirketi sicil müdürlüğü ve sicil numarasıyla takibe alır. İstek beklemez: kayıt hemen açılır, ilanlar ve profil arka planda hazırlanır; durum_adresi ile izleyin
- [Hızlı sorgu (ön doldurma)](https://ulawk.com/gelistirici/api/hizli-sorgu.md): Ulawk dizinindeki şirketlerden anında aday: unvan, müdürlük, sicil no, hukuki biçim, durum, il, adres, kuruluş ve son ilan tarihi. Yalnız Ulawk'ın zaten işlediğ
- [Hazırlık durumu](https://ulawk.com/gelistirici/api/sirket-durumu.md): Yeni eklenen şirketin hazırlık aşaması: ilan çekimi → gazete arşivi → profil. hazir olana kadar birkaç dakikada bir sorgulayın. Şube kayıtlarında aşama doğrudan
- [Şirket profili](https://ulawk.com/gelistirici/api/sirket-profili.md): Kaynaklı tam profil: özet, kimlik, yetkililer, sermaye, ortaklık, unvan/adres, esas sözleşme, tek kronolojik değişiklik akışı, ilanlar ve rapor bulguları. Her k
- [Yetkililer (tarihli)](https://ulawk.com/gelistirici/api/yetkililer.md): Verilen tarihte görevde olan yetkililer (sıfat, temsil şekli, görev dönemi, kaynak). tarih verilmezse güncel yetkililer. Sözleşmeyi imzalayanın o tarihte yetkil
- [Görev bitişleri](https://ulawk.com/gelistirici/api/gorev-bitisleri.md): Tüm şirketlerinizde görev süresi gun içinde dolacak ya da yenilenmeden dolmuş yetkililer (kalan gün sırasıyla). Hatırlatma ve takvim entegrasyonu için.
- [Doğrulama raporu](https://ulawk.com/gelistirici/api/dogrulama-raporu.md): Şirketin kaynaklı profilinden mühürlü doğrulama raporu (PDF). Her bilgi kaynak ilanın künyesini (tarih · sayı · sayfa) ve birebir alıntıyı taşır; kapakta mühür:
- [İmza yetkisi kontrolü](https://ulawk.com/gelistirici/api/imza-kontrol.md): "Bu kişi bu tarihte, bu işlem ve tutar için şirketi temsil edebilir mi?" Sonuç ilanlardaki temsil kararlarından, görev dönemlerinden ve varsa iç yönergeden çıka
- [İmza kontrolü (sorguyla) ve kişi listesi](https://ulawk.com/gelistirici/api/imza-kontrol-sorgu.md): kisi verilmezse profildeki yetkili adları (görevdekiler önce) döner; verilirse POST ile aynı kontrol sorgu parametreleriyle yapılır ( birlikte tekrarlanabilir y
- [Şirketin değişiklikleri](https://ulawk.com/gelistirici/api/sirket-degisiklikleri.md): Her değişiklik kaynak gazetesiyle: yetkili atama/ayrılma, sermaye, ortaklık, unvan/adres, esas sözleşme ve durum değişiklikleri tek kronolojik akışta (yeniden e
- [Tüm şirketlerde son değişiklikler](https://ulawk.com/gelistirici/api/gunluk-degisiklikler.md): Tüm şirketlerinizdeki son değişiklikler tek akışta; her satırda hangi şirket. Günde bir istekle günlük değişiklikleri çekmek için. Webhook istemiyorsanız bu ucu
- [Şirketin ilanları](https://ulawk.com/gelistirici/api/ilanlar.md): Ş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.
- [Gazete PDF'i](https://ulawk.com/gelistirici/api/ilan-pdf.md): İlanın yayımlandığı gazetenin PDF'i, arşivimizden. indir=1 ile dosya olarak iner. Gazete henüz arşive inmediyse 404 arsivde_yok (yeniden denenebilir).
- [Gazete sayfası görseli](https://ulawk.com/gelistirici/api/ilan-sayfasi.md): Gazetenin n. sayfasının PNG görseli. kaynak.vurgu.kutular içindeki oransal kutuları bu görselin üzerine çizerek bilginin yerini işaretleyin.
- [Tüm gazeteler (ZIP)](https://ulawk.com/gelistirici/api/sirket-gazeteleri.md): Şirketin arşivdeki tüm gazete PDF'leri tek ZIP dosyasında (dosya adları tarih ve ilan türüyle).
- [Gazete arşivi](https://ulawk.com/gelistirici/api/gazete-arsivi.md): Tüm ilanlarınızın arşivdeki gazeteleri: ilan, şirket, gazete kimliği, sayfa sayısı, boyut ve PDF bağlantısı. Sayfalı.
- [KAP bildirimleri](https://ulawk.com/gelistirici/api/kap.md): Şirketin eşleştiği KAP üyesi, kurucusu olduğu fonlar ve şirketin/fonların son KAP bildirimleri (konu, özet, ekler). Eşleşme yoksa 404 kap_eslesmesi_yok (taraf k
- [Raporlar](https://ulawk.com/gelistirici/api/raporlar.md): Rapor Al raporlarınız (sayfalı). Liste hız için rapor içeriğini taşımaz; bulgular şirket profilinin raporlar alanında gelir.
- [Rapor dosyası](https://ulawk.com/gelistirici/api/rapor-dosyasi.md): Raporun dosyası: rapor (PDF), sermaye (PDF), rapor-word (DOCX), sermaye-excel (XLSX), ek-excel (XLSX).
- [Yaptırım taraması](https://ulawk.com/gelistirici/api/yaptirim-tara.md): En çok 500 adı yaptırım listelerinde tarar. Eşleşme yalnız birebir addır: adın tüm parçaları aynı olmalı (sıra, aksan ve büyük/küçük harf farkı hariç). Sonuç ol
- [Webhook'ları listele](https://ulawk.com/gelistirici/api/webhook-listesi.md): Webhook'larınız (gizli anahtar hariç) ve geçerli kategoriler.
- [Webhook ekle](https://ulawk.com/gelistirici/api/webhook-ekle.md): 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 i
- [Webhook ayrıntısı](https://ulawk.com/gelistirici/api/webhook-ayrintisi.md): Webhook ve son 20 teslim (durum, deneme sayısı, HTTP kodu).
- [Webhook'u güncelle](https://ulawk.com/gelistirici/api/webhook-guncelle.md): aktif ve/veya kategoriler . Yeniden açmak art arda hata sayacını sıfırlar.
- [Webhook'u sil](https://ulawk.com/gelistirici/api/webhook-sil.md): Webhook'u ve teslim günlüğünü siler.
- [Test bildirimi gönder](https://ulawk.com/gelistirici/api/webhook-test.md): 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_tes
- [Kapsam kataloğu](https://ulawk.com/gelistirici/api/katalog.md): Ülke ülke kapsam: kimlikler, veri noktaları, belgeler, yenileme ve yanıt süresi. Anahtarsız, salt okunur, önbellekli (Cache-Control). Yalnız müşteriye açık ülke
- [Tek ülkenin kapsamı](https://ulawk.com/gelistirici/api/katalog-ulke.md): Tek ülkenin katalog kaydı. Bilinmeyen ya da henüz açılmamış ülke 404.
- [Hizmet durumu](https://ulawk.com/gelistirici/api/hizmet-durumu.md): Ulawk ve kaynakların gün gün durumu (yalnız tarih). Anahtarsız, önbellekli. Sayfa hali /durum/.
- [Eski şirket listesi](https://ulawk.com/gelistirici/api/eski-sirketler.md): İlk sürümden kalan uç; çalışmayı sürdürür. Yeni entegrasyonlarda /api/v1/sirketler/ kullanın. Deneme anahtarını tanımaz.
- [Eski profil](https://ulawk.com/gelistirici/api/eski-profil.md): İlk sürümden kalan profil ucu; çalışmayı sürdürür. Yeni entegrasyonlarda /api/v1/sirketler/{sirket_id}/ kullanın: kaynak izi ve veri_durumu yalnız orada.

## Değişiklik günlüğü

- [Değişiklik günlüğü](https://ulawk.com/gelistirici/degisiklik-gunlugu.md): API ve belge değişiklikleri.