Doğrulama ve imza · Deneme ortamında

İmza yetkisi kontrolü

POST/api/v1/sirketler/{sirket_id}/imza-kontrol/

"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 çıkarılır: yetkili, yetkili_degil ya da belirsiz. Her gerekçe kaynak ilanını taşır. Müşterek temsilde birlikte ile birlikte imzalayanları verin. Hukuki görüş değildir; güncel imza sirküleriyle teyit edin. Aynı girdi GET sorgusuyla da verilebilir.

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).

İstek gövdesi application/json

kisistringzorunlu
Yetkilinin adı soyadı (zorunlu; büyük/küçük harf ve aksan farkı önemsiz).
tarihstring (date)isteğe bağlı
İmza tarihi YYYY-AA-GG (varsayılan bugün).
tutarnumber | stringisteğe bağlı
İşlem tutarı (1500000 ya da "1.500.000,00"); iç yönergedeki sınırla karşılaştırılır.
para_birimistringisteğe bağlı
Varsayılan TRY. varsayılan: "TRY"
islemstringisteğe bağlı
İşlem türü (ör. kredi, satış); boş = genel temsil.
birliktestring[]isteğe bağlı
Birlikte imzalayacakların adları (müşterek temsil; en çok 10).

Yanıt alanları

200 Kontrol sonucu. 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ı.
kisistringzorunlu
tarihstring (date)zorunlu
islemstringzorunlunull olabilir
tutarnumberzorunlunull olabilir
para_birimistringzorunlunull olabilir
sonucstringzorunlu
yetkili · yetkili_degil · belirsiz (ilanlardan karar verilemiyor; gerekçelere bakın). Değerler: yetkili, yetkili_degil, belirsiz
sonuc_adstringzorunlu
sonuc_enstringzorunlu
bicimstringzorunlunull olabilir
Yetki biçimi. Değerler: tek_basina, birlikte
bicim_adstringzorunlunull olabilir
bicim_enstringzorunlunull olabilir
gerekcelerobject[]zorunlu
- kodstringzorunlu
- etkistringzorunlu
  Değerler: olumlu, olumsuz, belirsiz, bilgi
- metinstringzorunlu
- metin_enstringzorunlu
- kaynakImzaKaynakzorunlunull olabilir
  ilan_idintegerzorunlu
  ilan_tarihistringzorunlunull olabilir
  sayistringzorunlu
  sayfastringzorunlu
  ilan_turustringzorunlu
  alintistringzorunlu
  alinti_dogrulandibooleanzorunlu
  gazete_pdfstring (uri)zorunlunull olabilir
kurallarobject[]zorunlu
Uygulanan temsil kuralları (ilan ya da iç yönerge).
- kapsamstringzorunlu
- bicimstringzorunlunull olabilir
- tutar_siniristringzorunlunull olabilir
- kimstringzorunlu
- maddestringzorunlu
- birlikte_imzastring[]zorunlu
- alintistringzorunlu
- ilanImzaKaynakzorunlunull olabilir
  ilan_idintegerzorunlu
  ilan_tarihistringzorunlunull olabilir
  sayistringzorunlu
  sayfastringzorunlu
  ilan_turustringzorunlu
  alintistringzorunlu
  alinti_dogrulandibooleanzorunlu
  gazete_pdfstring (uri)zorunlunull olabilir
- kaynak_turustringzorunlu
  Değerler: ilan, ic_yonerge
birlikte_imzastring[]zorunlu
Müşterek temsilde birlikte imzalayabilecekler.
gorev_kayitlariobject[]zorunlu
- isimstringzorunlunull olabilir
- sifatstringzorunlunull olabilir
- temsilstringzorunlunull olabilir
- baslangicstringzorunlunull olabilir
- bitisstringzorunlunull olabilir
- bitis_nedenistringzorunlunull olabilir
- gorev_bitisstringzorunlunull olabilir
- gorev_dayanakstringzorunlunull olabilir
- kaynakImzaKaynakzorunlunull olabilir
  ilan_idintegerzorunlu
  ilan_tarihistringzorunlunull olabilir
  sayistringzorunlu
  sayfastringzorunlu
  ilan_turustringzorunlu
  alintistringzorunlu
  alinti_dogrulandibooleanzorunlu
  gazete_pdfstring (uri)zorunlunull olabilir
- bitis_kaynakImzaKaynakzorunlunull olabilir
  ilan_idintegerzorunlu
  ilan_tarihistringzorunlunull olabilir
  sayistringzorunlu
  sayfastringzorunlu
  ilan_turustringzorunlu
  alintistringzorunlu
  alinti_dogrulandibooleanzorunlu
  gazete_pdfstring (uri)zorunlunull olabilir
- temsil_kaynakImzaKaynakzorunlunull olabilir
  ilan_idintegerzorunlu
  ilan_tarihistringzorunlunull olabilir
  sayistringzorunlu
  sayfastringzorunlu
  ilan_turustringzorunlu
  alintistringzorunlu
  alinti_dogrulandibooleanzorunlu
  gazete_pdfstring (uri)zorunlunull olabilir
profil_hazirbooleanzorunlu
sinirlarstring[]zorunlu
sinirlar_enstring[]zorunlu
uyaristringzorunlu
Sonuç ilanlara dayanır; güncel imza sirküleriyle teyit edin.
uyari_enstringzorunlu

Hata yanıtları

400eksik_parametre (kisi yok), gecersiz_tarih, gecersiz_tutar, gecersiz_govde, gecersiz_parametre.
404Bulunamadı ya da erişim yetkiniz yok (bulunamadi).
405GET ya da POST bekleniyor (yontem).
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

İmza yetkisi kontrolü

#Kimlik doğrulama

#Yol parametreleri

#İstek gövdesi application/json

#Yanıt alanları

#Hata yanıtları

Kimlik doğrulama

Yol parametreleri

İstek gövdesi application/json

Yanıt alanları

Hata yanıtları