Sandbox ortamı

Sandbox nedir?

Sandbox, canlı veri ve ücretlendirme riski olmadan entegrasyon testi yapmanız için ayrılmış ortamdır. Sınırsızdır, kredi tüketmez ve yalnızca sentetik senaryolar döner. API sözleşmesi production ile aynıdır; gerçek TCKN kullanmayın.

Ücretsiz production kredileri sandbox ile karıştırılmamalıdır: live_ anahtarları gerçek eşleşme kontrolü yapar ve kredi kullanır. Base URL canlı ortamla aynıdır (https://api.kimlikapi.com/v1); ortam ayrımı uygulama tipi ve anahtar öneki (test_ / live_) ile yapılır.

API anahtarı öneki

Sandbox uygulamalarının anahtarı test_ ile başlar.

Sentetik test T.C. kimlik numaraları

Karar yalnızca T.C. kimlik numarasına bakar. Ad, soyad ve doğum tarihi sandbox sonucunda değişmez. Aşağıdaki numaralar checksum kurallarına uygundur ve belirli sonuçları deterministik üretir.

T.C. kimlik no	Sonuç özeti	Açıklama
10000000146	true	Başarılı doğrulama (verified: true)
20000000282	true	Başarılı doğrulama (verified: true)
30000000328	false	Eşleşme yok (verified: false)
40000000464	false	Eşleşme yok (verified: false)
50000000500	true (async)	Async gecikme simülasyonu (kuyrukta işlenir)
60000000646	—	Hata / başarısızlık simülasyonu (verified: null)

Listede olmayan numaralar

Tabloda olmayan her T.C. kimlik numarası sandbox’ta anında verified: true döner. Doğru ya da yanlış ad, soyad ve doğum tarihi bu sonucu değiştirmez. Eşleşmeme denemek için 30000000328 veya 40000000464 kullanın. Gerçek eşleşme kontrolü yalnızca live_ anahtarıyla production uygulamasında yapılır; o istekler kredi kullanır.

Production’a geçiş

Aktif abonelik ve yeterli kredi ile production tipinde yeni bir uygulama oluşturun veya mevcut planınızı doğrulayın.
live_ ile başlayan API anahtarını ve yeni secret değerini güvenli şekilde dağıtın.
Ortam değişkenlerinde BASE_URL ve anahtarları production değerleriyle güncelleyin; webhook URL ve imza doğrulamasını tekrar test edin.
İlk canlı isteklerde düşük hacimle başlayıp log ve kredi kullanımını panelden izleyin.