Doğrulama ve imza · Deneme ortamında
Doğrulama raporu
GET
/api/v1/sirketler/{sirket_id}/dogrulama-raporu.pdfŞ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: DOGRULANDI, KISMI ya da DOGRULANMADI. Rapor kimliği içerikten türetilir; aynı içerik aynı kimliği verir ve ?rapor=DR-… ile ücretsiz yeniden indirilir. ?bicim=json aynı içeriği JSON, ?bicim=html yazdırılabilir sayfa olarak verir. ?tam_zorunlu=1: mühür DOGRULANDI değilse 409 veri_eksik. Yanıt başlıkları: X-Ulawk-Rapor-Kimligi, X-Ulawk-Muhur, X-Ulawk-Icerik-Ozeti, X-Ulawk-Veri-Durumu.
Kimlik doğrulama
X-API-Keyheaderzorunluulk_…X-API-Secretheaderzorunluulsk_…
Yol parametreleri
sirket_idinteger | stringzorunluŞirket kimliği (/api/v1/sirketler/listesindekiid).
Sorgu parametreleri
dilstringisteğe bağlıen → İngilizce rapor (varsayılan Türkçe). Değerler:enraporstringisteğe bağlıÖnceki raporun kimliği: aynı anlık görüntü yeniden çizilir.bicimstringisteğe bağlıÇıktı biçimi. Değerler:pdf,json,htmlvarsayılan:pdftam_zorunlustringisteğe bağlı1 → yalnız DOGRULANDI raporu ver, değilse 409. Değerler:1indirstringisteğe bağlı1 → PDF'i dosya olarak indir. Değerler:1
Yanıt alanları
200 Rapor (PDF; ?bicim=json → JSON; ?bicim=html → HTML). application/json
rapor_kimligistringzorunluDR-XXXX-XXXX-XXXX: içerik özetinden; aynı içerik → aynı kimlik.muhurstringzorunluDeğerler:DOGRULANDI,KISMI,DOGRULANMADImuhur_adstringzorunluicerik_ozetistringzorunluİçeriğin SHA-256 özeti.uretim_tarihistring (date)zorunlubekleyen_bolumlerstring[]zorunluveriDogrulamaVerisizorunluRaporun dil bağımsız anlık görüntüsü; tarihler GG.AA.YYYY.surumintegerzorunludenemebooleanzorunlusirketSirketOzetzorunluidinteger | stringzorunluŞirket kimliği: gerçek anahtarda sayısal (ör. 1234); deneme anahtarında DENEME-… metni.unvanstringzorunlunull olabilirTicaret unvanı.mudurlukstringzorunlunull olabilirSicil müdürlüğü (ör. İSTANBUL).sicil_nostringzorunlunull olabilirTicaret sicil numarası.
profil_hazirbooleanzorunlumuhurMuhurzorunluMühür içeriğin doğruluğunu değil, bilgilerin kaynağa bağlılığını söyler.kodstringzorunluDOGRULANDI: çekirdek bölümler tam ve her bilgi doğrulanmış alıntıya bağlı · KISMI: profil hazır ama bir koşul sağlanmıyor (gerekçeler) · DOGRULANMADI: profil hazır değil. Değerler:DOGRULANDI,KISMI,DOGRULANMADIgerekcelerobject[]zorunlutrstringzorunluenstringzorunlu
veri_tamligiobject[]zorunlubolumstringzorunludurumstringzorunluDeğerler:tam,kismi,yok,hazirlaniyor,yayimlanmiyoryontemstringzorunlunull olabilirdayanakintegerzorunlunull olabilirsinirlarstring[]zorunluyapisalbooleanzorunluKısmi durum yalnız yapısal sınırdan mı (A.Ş. ortaklığı).
alintilarobjectzorunlutoplamintegerzorunludogrulananintegerzorunludogrulanmayanintegerzorunlukaynaksizintegerzorunlu
kimlikobjectzorunlunull olabilirunvanstringzorunlunull olabilirturstringzorunlumerkezstringzorunlukurulus_tarihistringzorunlusermayestringzorunluhukuki_bicimstringzorunluhukuki_bicim_enstringzorunlukaynakobjectzorunlunull olabilirilan_idintegerzorunlutarihstringzorunluİlan tarihi (GG.AA.YYYY).sayistringzorunluGazete sayısı.sayfastringzorunluGazete sayfası.alintistringzorunluİlandan kısa, birebir alıntı.dogrulandibooleanzorunlu
durumobjectzorunlunull olabilirkodstringzorunlunull olabiliradstringzorunlunull olabilirad_enstringzorunlunull olabiliruluslararasistringzorunlunull olabiliryerelstringzorunluaciklamastringzorunluaciklama_enstringzorunludayanakstringzorunlukaynakobjectzorunlunull olabilirilan_idintegerzorunlutarihstringzorunluİlan tarihi (GG.AA.YYYY).sayistringzorunluGazete sayısı.sayfastringzorunluGazete sayfası.alintistringzorunluİlandan kısa, birebir alıntı.dogrulandibooleanzorunlu
yetkililerRaporYetkilisi[]zorunlunull olabilirGörevdeki yetkililer (aynı kişinin en yeni ataması).isimstringzorunlunull olabilirsifatstringzorunlutemsilstringzorunlubaslangicstringzorunlugorev_bitisstringzorunlugorev_dayanakstringzorunlusuresi_dolmusbooleanzorunluyeni_kurulstringzorunluderecestringzorunlunull olabilirİmza derecesi (1, 2…).kaynakobjectzorunlunull olabilirilan_idintegerzorunlutarihstringzorunluİlan tarihi (GG.AA.YYYY).sayistringzorunluGazete sayısı.sayfastringzorunluGazete sayfası.alintistringzorunluİlandan kısa, birebir alıntı.dogrulandibooleanzorunlu
temsil_kaynakobjectzorunlunull olabilirilan_idintegerzorunlutarihstringzorunluİlan tarihi (GG.AA.YYYY).sayistringzorunluGazete sayısı.sayfastringzorunluGazete sayfası.alintistringzorunluİlandan kısa, birebir alıntı.dogrulandibooleanzorunlu
birliktestring[]isteğe bağlıMüşterek temsilde birlikte imzalayabilecekleri (yalnız görevdekilerde).
bitmis_gorunen_yetkililerRaporYetkilisi[]zorunlunull olabilirSüresi dolmuş ve sonraki seçimde adı geçmeyenler.isimstringzorunlunull olabilirsifatstringzorunlutemsilstringzorunlubaslangicstringzorunlugorev_bitisstringzorunlugorev_dayanakstringzorunlusuresi_dolmusbooleanzorunluyeni_kurulstringzorunluderecestringzorunlunull olabilirİmza derecesi (1, 2…).kaynakobjectzorunlunull olabilirilan_idintegerzorunlutarihstringzorunluİlan tarihi (GG.AA.YYYY).sayistringzorunluGazete sayısı.sayfastringzorunluGazete sayfası.alintistringzorunluİlandan kısa, birebir alıntı.dogrulandibooleanzorunlu
temsil_kaynakobjectzorunlunull olabilirilan_idintegerzorunlutarihstringzorunluİlan tarihi (GG.AA.YYYY).sayistringzorunluGazete sayısı.sayfastringzorunluGazete sayfası.alintistringzorunluİlandan kısa, birebir alıntı.dogrulandibooleanzorunlu
birliktestring[]isteğe bağlıMüşterek temsilde birlikte imzalayabilecekleri (yalnız görevdekilerde).
sermayeobjectzorunlunull olabilirguncelstringzorunlukaynakobjectzorunlunull olabilirilan_idintegerzorunlutarihstringzorunluİlan tarihi (GG.AA.YYYY).sayistringzorunluGazete sayısı.sayfastringzorunluGazete sayfası.alintistringzorunluİlandan kısa, birebir alıntı.dogrulandibooleanzorunlu
gecmisobject[]zorunlutarihstringzorunluislemstringzorunluoncekistringzorunluyenistringzorunlukaynakobjectzorunlunull olabilirilan_idintegerzorunlutarihstringzorunluİlan tarihi (GG.AA.YYYY).sayistringzorunluGazete sayısı.sayfastringzorunluGazete sayfası.alintistringzorunluİlandan kısa, birebir alıntı.dogrulandibooleanzorunlu
ortaklarobjectzorunlunull olabiliranonimbooleanzorunlutarihstringzorunlunull olabilirlisteobject[]zorunluisimstringzorunlunull olabilirpay_tutaristringzorunlupay_oranistringzorunlukaynakobjectzorunlunull olabilirilan_idintegerzorunlutarihstringzorunluİlan tarihi (GG.AA.YYYY).sayistringzorunluGazete sayısı.sayfastringzorunluGazete sayfası.alintistringzorunluİlandan kısa, birebir alıntı.dogrulandibooleanzorunlu
uyumobject[]zorunlunull olabilirturstringzorunluadstringzorunlunull olabilirad_enstringzorunlunull olabiliraktifbooleanzorunlunull olabiliraciklamastringzorunluaciklama_enstringzorunludayanakstringzorunlutarihstringzorunlukaynakobjectzorunlunull olabilirilan_idintegerzorunlutarihstringzorunluİlan tarihi (GG.AA.YYYY).sayistringzorunluGazete sayısı.sayfastringzorunluGazete sayfası.alintistringzorunluİlandan kısa, birebir alıntı.dogrulandibooleanzorunlu
yaptirimobjectzorunluYalnız birebir ad isabetleri; deneme ortamında tarama yapılmaz.tarandibooleanzorunludenemebooleanzorunlutarananintegerzorunluisabetlerobject[]zorunluadstringzorunlurolstringzorunlulistestringzorunlunull olabilirliste_kaydistringzorunluprogramstringzorunlu
liste_tarihistringzorunlu
degisikliklerobject[]zorunluSon 10 değişiklik.tarihstringzorunluturstringzorunlukategoristringzorunluozetstringzorunluozet_enstringzorunlukaynakobjectzorunlunull olabilirilan_idintegerzorunlutarihstringzorunluİlan tarihi (GG.AA.YYYY).sayistringzorunluGazete sayısı.sayfastringzorunluGazete sayfası.alintistringzorunluİlandan kısa, birebir alıntı.dogrulandibooleanzorunlu
ilan_sayisiintegerzorunlu
pdfstring (uri)zorunluAynı raporun PDF'i (?rapor=… ile ücretsiz yeniden indirme).
Hata yanıtları
- 404Şirket ya da
?rapor=kimliği bulunamadı (bulunamadi). - 409
?tam_zorunlu=1ve mühür DOGRULANDI değil (veri_eksik;muhur,bekleyen_bolumler,rapor_kimligi). - 503PDF şu an üretilemedi (
pdf_uretilemedi,?bicim=htmldener) ya da kaynak erişilemiyor. - 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.