# Entegrasyonunuzu açık bir kapsamla başlatın.

> Legichain API dokümanlarına, SDK kaynaklarına ve entegrasyon bilgilerine ulaşın. İstek, yanıt ve hata senaryolarını inceleyin.

Kanonik URL: https://legichain.com/developers
Dil: tr
Diğer dil: https://legichain.com/en/developers

API yapısını, gerekli veri alanlarını ve yanıtları inceleyin. Ürününüze uygun kontrol akışını belirleyin.

- [API dokümanlarını açın](https://panel.legichain.com/api-docs)
- [Python SDK](https://github.com/legichain/legichain-python)

**İstek** — 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"
}
```

**Yanıt** — 200 · örnek yanıt

```
{
  "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
}
```

**Hata durumu** — 422 · doğrulama hatası

```
{
  "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.
```

## İ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.

- **Ürünü seçin.** — İhtiyacınız olan kontrolü ve kapsamını belirleyin.
- **Kimlik doğrulamayı yapılandırın.** — API erişim bilgilerini güvenli sunucu ortamında kullanın.
- **Örnek isteği çalıştırın.** — Test ortamının kullanım koşullarını takip edin.
- **Hata ve inceleme durumlarını uygulayın.** — Yalnızca başarılı yanıtı tasarlamayın.

## Kaynaklar.

- **API referansı** — İstek alanları, yanıt şeması ve hata kodları.
  - https://panel.legichain.com/api-docs
- **Python SDK** — Kamuya açık paket ve kullanım örnekleri.
  - https://github.com/legichain/legichain-python
- **Sistem durumu** — Güncel hizmet bilgisi.
  - https://legichain.com/status

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

- **Yetkilendirme** — Gizli anahtar yalnızca sunucu tarafında; istemci koduna konmaz.
- **İstek limitleri** — Limit yanıtlarını ve bekleme davranışını uygulayın.
- **Yeniden deneme** — Yalnızca yeniden denenebilir hatalarda; aynı referansla.
- **Günlükleme** — Günlüklerde kimlik ve cüzdan verisi maskelenir.
- **Hassas veri yönetimi** — Saklama ve erişim, sözleşme kapsamıyla uyumlu.
- **İnceleme durumu** — “review_required” yanıtı için ekip akışı tanımlı.

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

- [Teknik görüşme talep edin](https://legichain.com/contact?topic=integration)

---
Legichain — kimlik doğrulama, AML ve blockchain taraması için teknoloji. İletişim: contact@legichain.com