docufykit.comVerify. Extract. Deliver.
Giriş yapHızlı başlangıç

Entegrasyonunuz bir KYK yurt veya barinma belgesi bekliyorsa GSB_KYK_DORM kullanin.

Bu belge-tipi akisi authenticity-first modelini izler. Once gerceklik dogrulanir, sonra KYK yurt extraction ve karar kurallari uygulanir.

Request yapisi

Verification olustururken belge tipini gonderin:

{
  "document_type": "GSB_KYK_DORM",
  "process_type": "async",
  "external_reference_id": "dorm-12345",
  "original_filename": "belge.pdf",
  "file_size_bytes": 160585
}

Ayni imzali upload akisi devam eder:

  1. verification olustur
  2. PDF'i imzali URL'ye yukle
  3. upload-complete cagir
  4. webhook veya result sorgusuyla sonucu al

Ne dogrulaniyor

Mevcut urun davranisi authenticity-first modelidir:

  • worker yuklenen baytlari dogrular
  • platform yapilandirilmis authority adapter ile authenticity kontrolleri yapar
  • yurt-belgesi-ozel extraction sadece authenticity basarili olduktan sonra calisir

Yuklenen dosya authenticity kontrollerinden gecmiyorsa extraction sonucundaki barinma verisine guvenmeyin.

Yapilandirilmis veri alanlari

Shipped sema surumu 1.1.0'dir.

Mevcut normalize payload alanlari:

  • name
  • last_name
  • father_name
  • mother_name
  • birth_date
  • city
  • county
  • dorm_name
  • registered_date
  • student_in_dorm

Entegrasyon notu:

  • bu belge tipi icin temel is alani student_in_dorm alanidir
  • student_in_dorm degeri true oldugunda validation kurallari city, county, dorm_name ve gecerli bir registered_date bekler
  • belge kisinin su anda yurtta barinmadigini soyluyorsa bu yurt-ozel alanlar daha az bilgilendirici olabilir; buna ragmen belgenin authenticity'si basarili olabilir

Beklenen sonuc davranisi

GSB_KYK_DORM su an uc farkli terminal sonuc uretebilir:

verified

Belge su kosullarda verified olur:

  • authenticity dogrulanir
  • yapilandirilmis veri vardir ve decode edilebilir
  • sema dogrulamasi basarilidir
  • confidence, otomatik verification esiginin uzerindedir
  • student_in_dorm degeri true'dur

Terminal reason code:

  • verified_gsb_kyk_dorm

review_required

Yurt-belgesi-ozel extraction yolu eksik veya dusuk guvenliyse sonuc review_required olur.

Mevcut review-oriented reason code'lar:

  • gsb_kyk_dorm_structured_data_missing
  • gsb_kyk_dorm_payload_invalid
  • gsb_kyk_dorm_schema_invalid
  • gsb_kyk_dorm_low_confidence

rejected

Authenticity basarili olsa bile belge kisinin su anda KYK yurdunda barinmadigini soyluyorsa sonuc rejected olabilir.

Terminal reason code:

  • gsb_kyk_dorm_not_accommodated

Bu yurt-ozel sonuclardan once genel authenticity hatalari da gelebilir. Ornekler:

  • source_verification_failed
  • authenticity_missing_qrcode
  • authenticity_source_missing
  • authenticity_hash_mismatch
  • authenticity_lookup_failed

Ornek normalize payload

{
  "name": "Jane",
  "last_name": "Customer",
  "father_name": "Mehmet",
  "mother_name": "Ayse",
  "birth_date": "2002-04-18",
  "city": "Ankara",
  "county": "Cankaya",
  "dorm_name": "Example KYK Dorm",
  "registered_date": "2023-09-20",
  "student_in_dorm": true
}

Entegrasyon notlari

  • Ust seviye status ile birlikte reason_code degerini de saklayin.
  • Asagidaki is akislarinda temel sonuc alani olarak student_in_dorm kullanin.
  • rejected sonucu ile review_required sonucunu ayni gibi ele almayin; farkli seyler ifade ederler.
  • Destek araclarinizda authenticity hatalarini yurt-durumu hatalarindan ayri tutun.
  • Sandbox ve production icin ayri app, key ve webhook URL kullanin.

Ilgili dokumanlar