Geliştiriciler

REST API ile hızlı entegrasyon; sandbox ile güvenli test.

Hızlı başlangıç

1. Kayıt olun ve kontrol panelinden bir uygulama oluşturun.
2. API anahtarınızı kopyalayın ve isteklerinize Authorization başlığında kullanın. Sandbox için test_ ile başlayan anahtar; production (canlı) için live_ ile başlayan anahtar kullanılır.
3. İlk doğrulama isteğinizi gönderin; önce sandbox ortamında doğrulayın.

Örnek istek ve yanıt

# İstek
POST /v1/verify
Authorization: Bearer test_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{
  "id_number": "10000000146",
  "first_name": "Test",
  "last_name": "Kullanici",
  "birth_date": "1990-01-15",
  "mode": "async",
  "reference_id": "demo-1"
}

# Örnek yanıt (202 — kabul edildi)
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "reference_id": "demo-1",
  "status": "pending"
}

Senkron ve asenkron

Üretimde async önerilir. Senkron modda yanıt aynı HTTP isteğinde döner; asenkron modda işlem arka planda yürür; önbellekte sonuç varsa anında dönebilir. Durum sorgulama veya webhook ile tamamlanma bildirimi alırsınız.

Webhook

Uygulama ayarlarında webhook URL tanımlayabilirsiniz. Bildirimler uygulama gizli anahtarınız ile HMAC imzalanır; sunucunuzda imzayı doğrulayarak güvenli teslim alın.

Sandbox

Sandbox uygulamaları sınırsızdır: sentetik senaryolar döner, kredi tüketmez ve production verisine karışmaz. Ücretsiz production kredileri ayrı bir kavramdır; live_ anahtarları gerçek eşleşme kontrolü yapar ve kredi kullanır.

AI / MCP ready

Docs-first MCP sunucusu (/mcp), /llms.txt ve /openapi.yaml ile asistanınıza API anahtarı vermeden entegrasyon bağlamı sağlayabilirsiniz.