YOK_STUDENT belge tipi | Docufykit Docs

Entegrasyonunuz bir universite ogrenci belgesi bekliyorsa YOK_STUDENT kullanin.

Bu belge-tipi yolu genel OCR degildir. Mevcut akista once authenticity dogrulamasi yapilir, sonra YOK-ozel extraction ve karar kurallari uygulanir.

Request yapisi

Verification olustururken belge tipini gonderin:

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

Ayni imzali upload akisi devam eder:

verification olustur
PDF'i imzali URL'ye yukle
upload-complete cagir
webhook veya result sorgusuyla sonucu al

Ne dogrulaniyor

YOK_STUDENT icin mevcut urun davranisi authenticity-first modelidir:

worker QR veya barcode bilgisini cikarir
platform yapilandirilmis authority adapter ile belgeyi dogrular
yuklenen dosya dogrulanan authority baytlariyla eslesmiyorsa islem kisa devreyle durur
yapilandirilmis extraction sadece authenticity kontrolleri gectikten sonra guvenilir kabul edilir

Yuklenen dosya authenticity kontrollerinden gecmiyorsa extraction sonucunu gecerli bir ogrenci belgesi sonucu olarak kabul etmeyin.

Yapilandirilmis veri alanlari

Shipped sema surumu 1.1.0'dir.

Normalize payload icindeki zorunlu alanlar:

full_name
mother_name
father_name
birth_date
nationallity
registered_at
education_type
education_duration_year
status
is_active
class
program
barcode

Bulunursa donen opsiyonel alanlar:

university_name
faculty_name
department_name
program_name

Onemli uyumluluk notu:

mevcut payload anahtari shipped semada ve JSON sonucunda nationallity olarak yazilmistir
entegrasyonlar bugun donen anahtari birebir tuketmelidir

Extractor, program yolunu alt alanlara ayirir ve status metni tanindiginda is_active degerini bu metinden turetir.

Beklenen sonuc davranisi

YOK_STUDENT su kosullar saglandiginda verified olarak tamamlanabilir:

document authenticity dogrulanir
yapilandirilmis veri vardir ve decode edilebilir
sema dogrulamasi basarilidir
confidence, otomatik verification esiginin uzerindedir

YOK-ozel extraction yolu eksik veya dusuk guvenliyse sonuc review_required olarak geri duser.

Mevcut YOK-ozel karar sonuclari:

verified_yok_student: authenticity dogrulandi ve YOK verisi basariyla cikartildi
yok_student_structured_data_missing: authenticity gecti ama yapilandirilmis payload yok
yok_student_payload_invalid: yapilandirilmis payload var ama decode edilemiyor
yok_student_schema_invalid: decode edilen payload sema dogrulamasini gecemedi
yok_student_low_confidence: authenticity gecti ama extraction confidence'i otomatik verification esiginin altinda

Bu YOK-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

{
  "full_name": "Jane Customer",
  "mother_name": "Ayse",
  "father_name": "Mehmet",
  "birth_date": "2002-04-18",
  "nationallity": "TURK",
  "registered_at": "2021-09-20",
  "education_type": "Lisans",
  "education_duration_year": 4,
  "status": "Aktif",
  "is_active": true,
  "class": "3",
  "program": "Muhendislik Fakultesi / Bilgisayar Muhendisligi",
  "university_name": "Example University",
  "faculty_name": "Muhendislik Fakultesi",
  "department_name": "Bilgisayar Muhendisligi",
  "program_name": "Bilgisayar Muhendisligi",
  "barcode": "YOKOG3REQTMB1Y9WCC"
}

Entegrasyon notlari

Ust seviye status ile birlikte reason_code degerini de saklayin.
Bu belge tipi icin stabil makine-tarafindan-okunabilir basari yolu olarak verified_yok_student degerini kullanin.
review_required akisini genel hata gibi kapatmayin; operator gorunurlugu saglayin.
Donen status metnini yok sayiyorsaniz is_active alanini tek basina yeterli kabul etmeyin.
Sandbox ve production icin ayri app, key ve webhook URL kullanin.