tcdogrula

Nasıl Çalışır

tcdogrula ile T.C. kimlik doğrulamasını uygulamanıza birkaç adımda bağlayın.

  1. Adım 1

    API anahtarı alın

    Hesap oluşturun, bir uygulama (sandbox veya production (canlı)) tanımlayın ve kontrol panelinden API anahtarı ile gizli anahtarınızı edinin.

  2. Adım 2

    POST /v1/verify endpoint'ine istek gönderin

    Kimlik doğrulama isteğinizi HTTPS üzerinden, API anahtarı ile yetkilendirerek gönderin. İstek gövdesi ve alanların tam listesi API Dokümantasyonusayfasında yer alır.

  3. Adım 3

    Sonucu alın

    Senkron modda anında yanıt alırsınız; asenkron modda işlem arka planda yürür; durumu sorgulayarak veya webhook ile sonucu alırsınız. Önbellekte sonuç varsa anında dönebilir.

Kişisel veri ve yanıt içeriği

API, müşteri tarafında ilettiğiniz kimlik alanlarını yanıtta geri göndermez; yalnızca doğrulama sonucu ve teknik metaveriler döner. Eşleştirmeyi kendi veritabanınızda siz yaparsınız. Ayrıntılar için API Dokümantasyonu'na bakın.

Senkron ve asenkron

Profesyonel entegrasyonlar için asenkron mod önerilir: zaman aşımı riski düşer, webhook veya polling ile sonuç alırsınız. Senkron mod basit akışlar ve önbellekten hızlı sonuçlar için uygundur.

Senkron

İstek tamamlanana kadar bağlantı açık kalır; tek tek istekte sonuç döner. Manuel doğrulama süreci uzadığında istemci zaman aşımı riski vardır.

Asenkron (önerilen)

Hemen bir istek kimliği alırsınız; işlem arka planda sürer. Önbellekte sonuç varsa aynı yanıtta anında döner. Yoksa polling veya webhook kullanın.

Önbelleğin avantajı

Aynı doğrulama parametreleri tekrar gönderildiğinde, TTL süresi içinde önbellekten yanıt dönebilir — bu hem maliyet hem gecikmeyi iyileştirir. Gerektiğinde önbelleği atlamak için seçenekler önbellek dokümantasyonunda açıklanır.

Örnek: cURL

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

Örnek yanıt (özet)

HTTP/1.1 202 Accepted

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing"
}

Asenkron modda önbellekte sonuç yoksa 202 ile request_id döner; sonucu webhook veya polling ile alırsınız. Önbellekte sonuç varsa yanıt anında 200 ve completed olur.

Ücretsiz Başla →