Kullanim senaryosu

Ogrenci dogrulama akisi

Bu akis, bir kisinin aktif ogrenci oldugunu gercek bir E-Devlet kaynakli belge uzerinden dogrulamak zorunda olan ve onboarding, fiyatlandirma ya da uygunluk kararini buna gore veren urunler icindir.

Akis

Dogrulama yolu nasil calisir

Shipped akis authenticity-first modelindedir. Platform, yuklenen PDF'i yukari akistaki E-Devlet kaynak belgesiyle eslestirmeden guvenilir kabul etmez.

1

Verification olustur

Backend'iniz YOK_STUDENT, kendi external reference degeriniz ve bir Idempotency-Key ile POST /v1/verifications cagrisi yapar.

2

Kaynak PDF'i yukle

Musteri sistemi, create response'undan gelen signed upload hedefine ham E-Devlet PDF'ini gonderir.

3

Yukleme tamamlandi cagrisi yap

Stored object dosya, boyut ve guvenlik kontrollerini gectikten sonra upload-complete adimi isi processing durumuna alir.

4

Extraction oncesi authenticity kontrolu yap

Worker QR veya barcode bilgisini okur, yukari akistaki kaynak belgeyi ceker ve yuklenen dosya bu belgeyle eslesmiyorsa akisi reddeder.

5

Yapilandirilmis sonucu kullan

Backend'iniz imzali webhook alir ve mutabakat icin status, reason_code ve yapilandirilmis ogrenci alanlarini REST uzerinden okuyabilir.

Yapilandirilmis veri

Urununuzun dallanabilecegi alanlar

Mevcut YOK akisinda, operasyonel kararlar icin generic OCR metninden daha kullanisli olan kayit odakli alanlar doner.

full_nameregistered_ateducation_typestatusis_activeclassprogramuniversity_namefaculty_name

Karar modeli

Production mantiginda beklenmesi gereken sonuclar

verified

verified_yok_student

Authenticity kontrolleri gecti, ogrenci semasi dogrulandi ve extraction confidence degeri otomatik verification esigini asti.

review_required

yok_student_schema_invalid veya yok_student_low_confidence

Authenticity gecti; ancak cikan sema eksik, gecersiz veya confidence esiginin altinda oldugu icin operatorlere acik kalmalidir.

rejected

authenticity_hash_mismatch ve diger source-verification hatalari

Yuklenen PDF, yukari akistaki E-Devlet kaynaginin dondurdugu ayni belge olarak guvenilir bulunmadi; bu nedenle asagidaki extraction sonucu gecerli kanit gibi kullanilmamalidir.