Kimlik API nedir?

Kimlik API nedir?

Kimlik API, kurumların NVİ yönlendirmesiyle manuel yürütmek zorunda kaldığı T.C. kimlik bilgisi eşleşme kontrolünü sizin yerinize yapan yönetilen bir hizmettir. Talebi API ile iletirsiniz; biz doğrulama işlemini gerçekleştirir, sonucu yine API (ve isteğe bağlı webhook) ile size bildiririz.

Resmî T.C. / KPS API değildir. NVİ veya KPS ile resmî ortaklık ya da yetkilendirme yoktur. Sonuç, gönderdiğiniz kimlik numarası, ad, soyad ve doğum tarihinin kamu doğrulama kaydıyla eşleşip eşleşmediğini gösterir.

Ne yapar, ne yapmaz?

API alanındaki verified, bilgiler eşleşti mi? anlamına gelir — “kimlik sahibi kanıtlandı” demek değildir.

Nasıl çalışır? (3 adım)

1. Talebi gönderin: Backend'iniz Authorization: Bearer <api_key> ile POST /v1/verify çağırır. Önerilen mod: async.
2. İşlemi bizim tarafımızda yönetiriz: Talebiniz, gizlilik sözleşmeli doğrulama ekibimiz tarafından manuel doğrulama işleminden geçirilerek sonuçlandırılır. Ham kimlik bilgileri yalnızca bu işlem için geçici kullanılır; sonuç alındıktan sonra silinir, kalıcı arşivde tutulmaz.
3. Sonucu alın: Webhook (önerilen) veya polling ile request_id üzerinden durumu ve eşleşme sonucunu alırsınız.

Ne kadar sürer?

Sonuçlar çoğunlukla 1-2 dakika içinde gelir; yoğun anlarda 10 dakikaya kadar uzayabilir. Bu bir hizmet seviyesi taahhüdü değil, beklenen süredir. Bu yüzden canlı doğrulama asenkron çalışır: doğrulamayı kullanıcı akışınızı kilitleyen bir adım olarak kurgulamayın. Kullanıcınızı içeri alın, yalnızca doğrulanmış kimlik bilgisi gerektiren işlemleri sonuç gelene kadar “doğrulama bekleniyor” durumunda tutun. Önerilen yapı: entegrasyon rehberi.

Kredi yalnızca talep sonuçlandığında, yani bilgilerin eşleşip eşleşmediği belirlendiğinde düşer. Sonuç üretilemeyen taleplerde kredi düşmez.

Hazır mısınız? Hızlı başlangıç ile sandbox'ta ilk isteğinizi gönderin.