Hızlı başlangıç

Birkaç dakikada sandbox'ta ilk asenkron doğrulama isteğinizi gönderin. Sandbox sınırsızdır, sentetik senaryolar kullanır ve kredi tüketmez. Ücretsiz production kredileri ayrı bir kavramdır; canlı anahtar (live_) gerçek doğrulama yapar.

  1. Hesap oluşturun
    Kayıt olun ve e-posta doğrulamasını tamamlayın. Hesabınızda otomatik bir test (test_) ve bir canlı (live_) uygulama oluşur.
  2. Sandbox API anahtarını alın
    Paneldeki test uygulamasından test_ önekli anahtarı kopyalayın. Detay: Sandbox.
  3. Asenkron istek gönderin
    Önerilen yol: mode: async. 202 yanıtındaki request_id'yi kaydedin — kendi sisteminizde eşleştirme için buna ihtiyacınız olacak.
  4. Sonucu alın
    Webhook tanımlıysa sonucu oradan alın (önerilen). Yoksa polling kullanın. Sync yalnızca kısa denemeler içindir.

Sandbox cURL örneği (async)

BASE_URL değerini kendi ortamınıza göre değiştirin. 10000000146 sandbox'ta başarılı eşleşme senaryosudur.

İstek

curl -sS -X POST "$BASE_URL/v1/verify" \
  -H "Authorization: Bearer test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "id_number": "10000000146",
    "first_name": "Test",
    "last_name": "Kullanici",
    "birth_date": "1990-01-15",
    "mode": "async",
    "reference_id": "demo-order-1"
  }'

Örnek yanıt (202 — kabul edildi)

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "reference_id": "demo-order-1",
  "status": "pending"
}

Bu request_id'yi kendi kaydınıza yazın. Durumu öğrenmek için:

curl -sS "$BASE_URL/v1/requests/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"