Geliştiriciler
Entegrasyonunuzu açık bir kapsamla başlatın.
API yapısını, gerekli veri alanlarını ve yanıtları inceleyin. Ürününüze uygun kontrol akışını belirleyin.
// Sunucu tarafından, gizli API anahtarıyla gönderilir
{
"subject": {
"type": "person",
"name": "Ali Örnek",
"birth_year": 1978,
"country": "TR"
},
"reference": "customer-2481"
}
{
"screening_id": "scr_example_7730",
"status": "review_required",
"matches": [
{
"candidate": "ALI ORNEK",
"source": {
"name": "Yaptırım listesi (örnek kaynak)",
"record_id": "SL-0419",
"data_as_of": "2026-08-28"
},
"matched_fields": ["name", "birth_year"],
"match_confidence": 0.72,
"risk_indicator": "high",
"recommendation": "review"
}
],
"decision": null
}
{
"error": {
"type": "validation_error",
"message": "subject.name alanı gerekli",
"retryable": false
}
}
// Yeniden deneme: yalnızca retryable=true olan hatalarda,
// aynı referansla ve artan bekleme süresiyle.
Başlangıç
İlk entegrasyon adımları.
Dört adımda kapsamı belirleyin, erişimi güvenli kurun ve yalnızca başarılı yanıtı değil inceleme ve hata durumlarını da uygulayın.
- 01Ürünü seçin.
İhtiyacınız olan kontrolü ve kapsamını belirleyin.
- 02Kimlik doğrulamayı yapılandırın.
API erişim bilgilerini güvenli sunucu ortamında kullanın.
- 03Örnek isteği çalıştırın.
Test ortamının kullanım koşullarını takip edin.
- 04Hata ve inceleme durumlarını uygulayın.
Yalnızca başarılı yanıtı tasarlamayın.
Kaynaklar
Kaynaklar.
-
API referansıDokümanı açın
İstek alanları, yanıt şeması ve hata kodları.
-
Python SDKGitHub deposu
Kamuya açık paket ve kullanım örnekleri.
-
Sistem durumuDurum sayfası
Güncel hizmet bilgisi.
Üretim öncesi
Üretim öncesi kontrol edin.
Yetkilendirme, istek limitleri, yeniden deneme davranışı, günlükleme ve hassas veri yönetimini uygulamanızın gereksinimleriyle birlikte değerlendirin. Webhook veya idempotency gibi özellikler yalnızca ilgili endpoint dokümanındaki kapsamda kullanılmalıdır.
- YetkilendirmeGizli anahtar yalnızca sunucu tarafında; istemci koduna konmaz.
- İstek limitleriLimit yanıtlarını ve bekleme davranışını uygulayın.
- Yeniden denemeYalnızca yeniden denenebilir hatalarda; aynı referansla.
- GünlüklemeGünlüklerde kimlik ve cüzdan verisi maskelenir.
- Hassas veri yönetimiSaklama ve erişim, sözleşme kapsamıyla uyumlu.
- İnceleme durumu“review_required” yanıtı için ekip akışı tanımlı.
Sık sorulan sorular
Entegrasyon hakkında.
API anahtarını istemci uygulamasına koyabilir miyim?
Gizli erişim bilgilerini herkese açık istemci koduna yerleştirmeyin. İlgili entegrasyonun yetkilendirme modelini izleyin.
Örnek yanıtlar canlı veri mi?
Dokümantasyon örnekleri örnek olarak etiketlenir. Canlı ürün yanıtı ile test verisi ayrılır.
Teknik bir sorunuz mu var?
Entegrasyon senaryonuzu paylaşın. Gerekli ürün ve veri kapsamını birlikte netleştirelim.