Token alın, kullanıcınızda doğrulayacağınız durumu seçin, ilgili istek gövdesini kopyalayın ve yanıttaki matches_request alanını kontrol edin.
Bu token’ı doğrulama isteklerinde kullanın. expires_in süresi dolana kadar aynı token’ı tekrar kullanabilirsiniz.
curl --request POST 'https://API_HOST/v1/oauth/token' \
--header 'Content-Type: application/json' \
--data '{
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET"
}'Tüm doğrulamalar aynı adrese ve başlıklara gönderilir. REQUEST_BODY yerine aşağıdaki örneklerden birini koyun.
curl --request POST 'https://API_HOST/v1/white-label/verifications' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data 'REQUEST_BODY'Aşağıdaki seçeneklerden birini açın. Entegrasyonu tamamlamak için diğer kodları öğrenmeniz gerekmez.
Desteklenen öğrenci belgelerinden herhangi birini kabul eder. YOKOG ve YOKEK aynı şekilde aktif üniversite öğrencisini doğrular.
students
Kullanabileceğiniz belge: YOKOG, YOKEK, MEB11 veya MEB01
{
"requested_eligibilities": [
"students"
],
"evidence": {
"type": "barcoded_document",
"identity_number": "10000000146",
"document_barcode": "YOKOGXXXXXXXXXXXX"
}
}Yalnızca öğretmen durumunu doğrular.
teacher
Kullanabileceğiniz belge: MEB15
{
"requested_eligibilities": [
"teacher"
],
"evidence": {
"type": "barcoded_document",
"identity_number": "10000000146",
"document_barcode": "MEB15XXXXXXXXXXXX"
}
}Yalnızca akademisyen durumunu doğrular.
academic
Kullanabileceğiniz belge: YOKAK
{
"requested_eligibilities": [
"academic"
],
"evidence": {
"type": "barcoded_document",
"identity_number": "10000000146",
"document_barcode": "YOKAKXXXXXXXXXXXX"
}
}Öğrenci, öğretmen veya akademisyen sonuçlarından herhangi biri sizin için yeterliyse bunu kullanın.
education
Kullanabileceğiniz belge: YOKOG, YOKEK, MEB11, MEB01, MEB15 veya YOKAK
{
"requested_eligibilities": [
"education"
],
"evidence": {
"type": "barcoded_document",
"identity_number": "10000000146",
"document_barcode": "YOKOGXXXXXXXXXXXX"
}
}Mezuniyet belgesindeki sağlık mesleği yeterliliğini doğrular. Güncel çalışma veya ruhsat durumunu doğrulamaz.
health_professionals
Kullanabileceğiniz belge: YOKME
{
"requested_eligibilities": [
"health_professionals"
],
"evidence": {
"type": "barcoded_document",
"identity_number": "10000000146",
"document_barcode": "YOKMEXXXXXXXXXXXX"
}
}Yalnızca tıp eğitimini doğrular; başka bir sağlık mesleğini kabul etmez. Güncel çalışma veya ruhsat durumunu doğrulamaz.
doctor
Kullanabileceğiniz belge: YOKME
{
"requested_eligibilities": [
"doctor"
],
"evidence": {
"type": "barcoded_document",
"identity_number": "10000000146",
"document_barcode": "YOKMEXXXXXXXXXXXX"
}
}Aşağıdaki iki istek gövdesinden birini kullanın.
lawyer
Kullanabileceğiniz belge: İstanbul Barosu barkodlu faaliyet belgesi veya sicil kaydı
{
"requested_eligibilities": [
"lawyer"
],
"evidence": {
"type": "barcoded_document",
"identity_number": "10000000146",
"document_barcode": "BARACTIVITYCODE"
}
}{
"requested_eligibilities": [
"lawyer"
],
"evidence": {
"type": "professional_registry",
"first_name": "TEST",
"last_name": "USER",
"registration_number": "00000"
}
}API bilgilerinizi ve doğrulayacağınız kullanıcıya ait bilgileri girin. Uygulama token alır, doğrulama isteğini gönderir ve API yanıtını değiştirmeden gösterir.
Her iki durumda da HTTP durumu 200 olabilir. Kullanıcınızın doğrulanıp doğrulanmadığını matches_request alanından anlayın.
{
"verification_id": "00000000-0000-4000-8000-000000000005",
"status": "completed",
"matches_request": true,
"message": "Talep edilen uygunluk doğrulandı.",
"requested_eligibilities": [
"students"
],
"matched_eligibilities": [
{
"code": "higher_education_student",
"label": "Aktif Üniversite Öğrencisi",
"group": "students",
"basis": "active_record",
"qualification_status": "active"
}
],
"subject": {
"first_name": "TEST",
"last_name": "USER",
"identity_number": "*******0146",
"birth_date": "01.01.2000"
},
"document": {
"type": "YOKOG",
"barcode": "YOKO*************",
"document_date": "01.09.2026",
"program": "ÖRNEK ÜNİVERSİTESİ/MÜHENDİSLİK FAKÜLTESİ/BİLGİSAYAR MÜHENDİSLİĞİ BÖLÜMÜ/BİLGİSAYAR MÜHENDİSLİĞİ PR."
},
"audit": {
"request_id": "00000000-0000-4000-8000-000000000006",
"evidence_fingerprint": "sha256-hmac-value",
"verified_at": "2026-08-13T12:00:00+03:00"
},
"data": {
"first_name": "TEST",
"last_name": "USER",
"birth_date": "01.01.2000",
"nationality": "TÜRKİYE CUMHURİYETİ",
"document_date": "01.09.2026",
"is_active": true,
"educations": [
{
"level": "ÖRGÜN ÖĞRETİM",
"registered_at": "01.09.2025",
"graduated_at": null,
"duration": 4,
"school": {
"full_program": "ÖRNEK ÜNİVERSİTESİ MÜHENDİSLİK FAKÜLTESİ BİLGİSAYAR MÜHENDİSLİĞİ BÖLÜMÜ BİLGİSAYAR MÜHENDİSLİĞİ PR.",
"university": "ÖRNEK ÜNİVERSİTESİ",
"faculty": "MÜHENDİSLİK FAKÜLTESİ",
"department": "BİLGİSAYAR MÜHENDİSLİĞİ",
"program": "BİLGİSAYAR MÜHENDİSLİĞİ",
"attributes": [],
"class": 1
}
}
]
}
}matched_eligibilities, belgede bulunan durumları listeler. Örneğin students isteği sonucunda higher_education_student dönebilir. Doğrulama başarılıysa belgeden veya sicilden alınan eğitim, sağlık ya da hukuk ayrıntıları data alanında döner. Bu alandaki T.C. kimlik numarası ve barkod maskelidir.
verification_id, bu sonucun kimliğidir. Sonucu daha sonra GET /v1/white-label/verifications/{verification_id} ile tekrar alabilirsiniz.
Bir hata olduğunda HTTP durumuna göre işlem yapın:
Destek talebinde T.C. kimlik numarası, barkod, Client Secret veya token göndermeyin.
Yukarıdaki yedi örnek ihtiyacınızı karşılıyorsa bu bölümü atlayabilirsiniz. Bu tablodaki kodların tamamı her müşteri hesabında kullanılabilir.
| Kod | Neyi kabul eder? | Belge veya kayıt |
|---|---|---|
students | Desteklenen herhangi bir öğrenci durumu | YOKOG, YOKEK, MEB11 veya MEB01 |
higher_education_student | Aktif üniversite öğrencisi | YOKOG veya YOKEK |
student_meb | MEB öğrencisi | MEB11 veya MEB01 |
teacher | Öğretmen | MEB15 |
academic | Akademisyen | YOKAK |
education | Öğrenci, öğretmen veya akademisyen | Desteklenen eğitim belgesi |
health_professionals | Herhangi bir sağlık mesleği | YOKME |
doctor | Doktor yeterliliği | YOKME |
lawyer | Avukat | Faaliyet belgesi veya sicil kaydı |
trainee_lawyer | Stajyer avukat | Faaliyet belgesi veya sicil kaydı |
legal_professionals | Avukat veya stajyer avukat | Faaliyet belgesi veya sicil kaydı |
all | Mevcut doğrulamalardan herhangi biri | Seçilen doğrulamaya uygun belge veya kayıt |
anesthesia_technician · Anestezi Teknikeriaudiologist · Odyologaudiometry_technician · Odyometri Teknikeriautopsy_assistant · Otopsi Yardımcısıbiomedical_device_technician · Biyomedikal Cihaz Teknikerichild_care_professional · Çocuk Koruma ve Bakım Hizmetleri Meslek Elemanıchild_development_specialist · Çocuk Gelişimcidental_prosthesis_technician · Diş Protez Teknikeridentist · Diş Hekimidialysis_technician · Diyaliz Teknikeridietitian · Diyetisyendigital_health_systems_technician · Dijital Sağlık Sistemleri Teknikeridisabled_care_and_rehabilitation_technician · Engelli Bakımı ve Rehabilitasyon Teknikeridoctor · Doktorelderly_care_technician · Yaşlı Bakımı Teknikerielderly_health_professional · Yaşlı Sağlığı Profesyonelielectroneurophysiology_technician · Elektronörofizyoloji Teknikeriemergency_and_disaster_manager · Acil Yardım ve Afet Yöneticisiemergency_and_disaster_technician · Acil Durum ve Afet Yönetimi Teknikerienvironmental_health_technician · Çevre Sağlığı Teknikerigerontologist · Gerontologhealth_information_systems_technician · Sağlık Bilgi Sistemleri Teknikerihealth_institutions_management_professional · Sağlık Kurumları İşletmecisihealth_manager · Sağlık Yöneticisihealth_tourism_professional · Sağlık Turizmi Profesyonelihome_patient_care_technician · Evde Hasta Bakımı Teknikerilaboratory_technician · Laboratuvar Teknikerimedical_data_processing_technician · Tıbbi Veri İşleme Teknikerimedical_imaging_technician · Tıbbi Görüntüleme Teknikerimedical_laboratory_technician · Tıbbi Laboratuvar Teknikerimedical_promotion_and_marketing_professional · Tıbbi Tanıtım ve Pazarlama Profesyonelimedical_secretary · Tıbbi Sekretermidwife · Ebenuclear_medicine_technician · Nükleer Tıp Teknikerinurse · Hemşireoccupational_health_and_safety_professional · İş Sağlığı ve Güvenliği Profesyonelioccupational_therapist · Ergoterapistoccupational_therapy_technician · İş ve Uğraşı Terapisi Teknikerioperating_room_technician · Ameliyathane Hizmetleri Teknikerioptician · Optisyenoral_and_dental_health_technician · Ağız ve Diş Sağlığı Teknikeriorthopedic_prosthetics_technician · Ortopedik Protez ve Ortez Teknikeriorthotist_prosthetist · Ortez-Protez Profesyoneliparamedic · Paramedikpathology_laboratory_technician · Patoloji Laboratuvar Teknikeripatient_care_technician · Hasta Bakımı Teknikeriperfusionist · Perfüzyonistpharmacist · Eczacıpharmacy_technician · Eczane Teknikeriphysiotherapist · Fizyoterapistphysiotherapy_technician · Fizyoterapi Teknikeripodologist · Podologradiotherapy_technician · Radyoterapi Teknikerisocial_services_professional · Sosyal Hizmetler Meslek Elemanısocial_worker · Sosyal Hizmet Uzmanıspeech_and_language_therapist · Dil ve Konuşma Terapististerilization_technician · Sterilizasyon Teknikeritelehealth_technician · Tele-Sağlık TeknikeriBu endpoint’i çağırın ve yanıtta dönen code değerini requested_eligibilities alanında kullanın.
curl 'https://API_HOST/v1/white-label/professionals/eligibilities' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'