Nasıl çalışır

Talebi gönderin, sonucu alın.

TC kimlik doğrulama için ekip ayırmanıza, ekranlarda form doldurmanıza gerek yok. Talebinizi API ile iletin; sizin adınıza sorgulayıp sonucu doğrudan yazılımınıza bildirelim.

Ücretsiz Başla API dokümantasyonu

01
Anahtarınızı alın
Hesabınızı açın, panelden bir uygulama oluşturun. Sandbox ile ücretsiz deneyin; hazır olduğunuzda canlı anahtara geçin.
02
Talebi gönderin
TC kimlik no, ad, soyad ve doğum tarihini tek bir API isteğiyle iletin. Talep anında kabul edilir; kullanıcınız akışına devam eder.
03
Sizin adınıza doğrulayalım
Talebinizi sizin yerinize manuel doğrulama işleminden geçiririz. Ekip ayırmanıza, form doldurmanıza gerek kalmaz.
04
Sonuç sisteminize düşsün
Sonuç hazır olduğunda imzalı webhook ile bildiririz; dilerseniz durumu API ile sorgularsınız. Daha önce doğrulanmış bilgiler anında döner.

Önerilen akış

Doğrulama sürerken akışınız durmasın.

Doğrulamayı üyelik formunuzun şartı yapmayın. Kullanıcınızı içeri alın, talebi gönderin ve “Doğrulamanız sürüyor, tamamlanınca haber vereceğiz” deyin. Yalnızca doğrulanmış kimlik gerektiren işlemleri sonuç gelene kadar bekletin; geri kalan her şey çalışmaya devam etsin.

1
Kayıt
Kullanıcı hesabını açar, panelinize girer.
2
Talep
Arka planda async talep gönderilir; kimlik durumu “doğrulama bekleniyor” olur.
3
Bekleme
Ödeme, sözleşme gibi kimlik gerektiren adımlar kısa süreliğine kilitli kalır.
4
Sonuç
Webhook gelir; işlemler açılır, kullanıcı bilgilendirilir.

Laravel ve Node örnekleri

Entegrasyon

Tek istek, anında kabul.

Talep 202 ile hemen kabul edilir ve size bir request_id döner. Sonuç webhook ile gelir; webhook kullanamıyorsanız durumu API ile sorgularsınız.

POST /v1/verify

curl "https://api.kimlikapi.com/v1/verify" \
  -X POST \
  -H "Authorization: Bearer test_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "id_number": "10000000146",
    "first_name": "Test",
    "last_name": "Kullanici",
    "birth_date": "1990-01-15",
    "mode": "async",
    "reference_id": "user_42"
  }'

# HTTP 202 Accepted
# {
#   "request_id": "9d3f6c1e-2b7a-4c55-9e0f-1a2b3c4d5e6f",
#   "reference_id": "user_42",
#   "status": "processing"
# }

Önerilen

Async + webhook

Talep hemen kabul edilir, işlem arka planda sürer. Önbellekte sonuç varsa aynı yanıtta 200 ile anında döner.

Önerilmez

Sync

Bağlantı en fazla 90 saniye açık kalır. Sonuç bu sürede gelmezse talep iptal edilmez; async olarak sürer ve 202 döner. İleride sync istekler kabul edilmeyebilir.

Aynı bilgiler önbellek süresi içinde tekrar gönderildiğinde sonuç anında döner. Önbelleği atlama seçenekleri önbellek dokümantasyonunda.

Arka planda

Şeffaf bir çalışma modeli.

Doğrulamayı nasıl yaptığımızı açıkça anlatıyoruz; entegrasyonunuzu ve süreçlerinizi buna göre planlayabilmeniz için.

Sorgulamayı kim yapar?

Talepler, bizimle iş ve gizlilik sözleşmesi bulunan doğrulama ekibimiz tarafından manuel doğrulama işleminden geçirilir. Resmî olmayan bir veri kaynağı kullanmayız.

Doğrulama ekibimiz

Ekip veriyi görür mü?

Kimlik bilgileri ekip üyesinin ekranında maskeli gösterilir; formu yardımcı yazılımımız doldurur. Maskeleme kapalı bir cihaza iş atanmaz.

Veri ne kadar tutulur?

Ham kimlik verisi yalnızca talep sonuçlanana kadar şifreli tutulur ve sonuçla birlikte silinir. Kalıcı kayıtta geri döndürülemez bir özet ve maskeli alanlar kalır.

Veri saklama modeli

Ne kadar sürer?

Talepler çoğunlukla 1–2 dakika içinde sonuçlanır; yoğun anlarda bu süre uzayabilir. Bu bir hizmet seviyesi taahhüdü değil, beklenen süredir. Bu yüzden entegrasyonu async kurmanızı istiyoruz.

API yanıtında gönderdiğiniz kimlik alanları geri dönmez; yalnızca doğrulama sonucu ve teknik metaveriler döner. Webhook bildirimleri de kimlik verisi içermez ve uygulama gizli anahtarınızla imzalanır. Güvenlik yaklaşımımız

Kimlik API'nin NVİ/KPS ile resmî ortaklığı veya yetkilendirmesi yoktur; resmî T.C. / KPS API'si değildir. Doğrulama sonucu, kimlik bilgilerinin eşleşmesini gösterir; tek başına KYC yerine geçmez.

Talebi gönderin, sonucu alın.

Anahtarınızı alın