Kimlik API

POST /v1/verify

Kimlik bilgisi eşleşme isteğini oluşturur. verified alanı, gönderdiğiniz bilgilerin eşleşip eşleşmediğini gösterir. mode alanına göre sonuç asenkron işleme ile (önerilen) veya aynı HTTP yanıtında döner.

Sync / async karar rehberi

Canlı doğrulama talepleri, gizlilik sözleşmeli doğrulama ekibimiz tarafından manuel doğrulama işleminden geçirilerek sonuçlandırılır. Sonuçlar çoğunlukla 1-2 dakika içinde gelir; yoğun anlarda 10 dakikaya kadar uzayabilir. Bu yüzden üretim entegrasyonunda async varsayılan olmalıdır: talep oluştur → request_id al → webhook bekle → gerekirse polling ile yedek kontrol. Doğrulamayı kullanıcı akışınızı kilitleyen bir adım olarak kurgulamayın; önerilen yapı entegrasyon rehberinde.

  1. Webhook alabiliyor musunuz? → mode: async + webhook (önerilen).
  2. Webhook alamıyorsanız → async + polling (ilk kontrol 30 sn sonra, ardından 30-60 sn aralıkla).
  3. mode: sync hâlâ kabul edilir, ancak önerilmez. Sunucu sonucu en fazla 90 saniye bekler. Sonuç bu sürede gelirse normal yanıt (200 veya hata) döner. Gelmezse talep iptal edilmez, async olarak sürer ve yanıt async moddaki gövdeyle 202 / status: processing olur. Kredi bu süre boyunca ayrılmış kalır; sonucu polling veya webhook ile alırsınız. Sync kullanıyorsanız istemci zaman aşımını en az 100 sn tutun ve 202 yanıtını işleyin. Sync istekler ileride kabul edilmeyebilir; entegrasyonunuzu async moda taşımanızı öneririz.

İstek gövdesi

AlanTipZorunluAçıklama
id_numberstring (11 hane)EvetT.C. kimlik numarası; yalnızca rakam, checksum geçerli olmalı.
first_namestringEvetAd (max 100 karakter).
last_namestringEvetSoyad (max 100 karakter).
birth_datestringEvetDoğum tarihi YYYY-MM-DD formatında.
modestringHayırsync veya async. Varsayılan: async.
skip_cachebooleanHayırProduction’da önbelleği atla; varsayılan false.
reference_idstringHayırKendi sisteminizdeki referans (max 255); yanıtta geri döner.

reference_id kullanımı

Kendi sisteminizdeki sipariş, başvuru veya kullanıcı kimliğini reference_id ile gönderin; yanıt, webhook ve polling sonuçlarında aynı değer geri döner. Böylece Kimlik API request_id ile kendi kayıtlarınızı eşleştirebilirsiniz.

Senkron yanıt örneği (200)

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "reference_id": "order-123",
  "status": "completed",
  "result": {
    "verified": true,
    "from_cache": false,
    "cached_at": null,
    "processed_at": "2026-03-31T12:00:00+00:00"
  },
  "credits": {
    "used": 1,
    "remaining": 499
  }
}

credits alanı production anahtarlarında döner; sandbox’ta bulunmaz.

Asenkron kabul yanıtı (202)

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "reference_id": null,
  "status": "processing",
  "message": "Doğrulama talebi alındı ve işleniyor."
}

Asenkron mod + önbellekten sonuç (200)

mode: async ile gönderilen isteklerde önbellekte geçerli sonuç varsa yanıt 200 OK ile anında döner; status alanı completed olur ve sonuç bilgisi yanıtta yer alır. Önbellekte sonuç yoksa 202 ve processing döner.

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "reference_id": "order-123",
  "status": "completed",
  "result": {
    "verified": true,
    "from_cache": true,
    "cached_at": "2026-03-28T08:00:00+00:00",
    "processed_at": "2026-03-31T12:00:00+00:00"
  },
  "credits": {
    "used": 1,
    "remaining": 499
  }
}

Yanıt başlıkları

  • X-Request-Id — İsteğe ait benzersiz kimlik (UUID).
  • X-Credits-Remaining — Production’da kalan kredi sayısı; sandbox’ta unlimited olabilir.