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.

Örnek veri
POST · isim taraması
// Sunucu tarafından, gizli API anahtarıyla gönderilir
{
  "subject": {
    "type": "person",
    "name": "Ali Örnek",
    "birth_year": 1978,
    "country": "TR"
  },
  "reference": "customer-2481"
}
Canlı endpoint çağrılmaz; yerel örnek yanıt gösterilir.

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.

  1. 01
    Ürünü seçin.

    İhtiyacınız olan kontrolü ve kapsamını belirleyin.

  2. 02
    Kimlik doğrulamayı yapılandırın.

    API erişim bilgilerini güvenli sunucu ortamında kullanın.

  3. 03
    Örnek isteği çalıştırın.

    Test ortamının kullanım koşullarını takip edin.

  4. 04
    Hata ve inceleme durumlarını uygulayın.

    Yalnızca başarılı yanıtı tasarlamayın.

Kaynaklar

Kaynaklar.

Ü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.