Geliştirici merkeziv1.0.0
Dokümantasyon menüsü
Başlangıç

Hızlı başlangıç

API anahtarıyla ilk server-side yaptırım sorgunuzu çalıştırın.

Bu akış onaylı bir API hesabı ve yalnız bir kez gösterilen sak_... biçiminde API key gerektirir.

1. Anahtarı güvenli saklayın

Anahtarı backend environment variable veya secret manager içinde tutun. Repository, frontend bundle, mobil binary, URL ve loglara yazmayın.

export SANCTIONS_API_KEY="sak_xxx"

2. İlk aramayı gönderin

POST /public/search, çoklu kaynak ve identifier filtreleri için önerilen yöntemdir.

curl -X POST "https://api.sanctions.tr/public/search" \
  -H "content-type: application/json" \
  -H "x-api-key: $SANCTIONS_API_KEY" \
  -d '{"name":"AEROCARIBBEAN AIRLINES","sources":["OFAC"],"pageSize":5}'

3. Cevabı yorumlayın

Başarılı cevapta status, total, results ve meta bulunur. Her sonuçtaki score, matchQuality, scoreDetails ve matchedFields birlikte değerlendirilmelidir.

4. Operasyonel karar verin

Bir eşleşme otomatik yaptırım veya hukuki uygunluk kararı değildir. Orta ve zayıf adayları, resmî kaynak referansları ve müşteri bağlamıyla insan incelemesine alın.

Kod örnekleri

curl -X POST "https://api.sanctions.tr/public/search" \
  -H "content-type: application/json" \
  -H "x-api-key: $SANCTIONS_API_KEY" \
  -d '{"name":"AEROCARIBBEAN AIRLINES","sources":["OFAC"],"pageSize":5}'

Karar sınırı

API sonucu aday eşleşmedir. Nihai yaptırım veya uygunluk kararı resmî kaynak doğrulaması ve insan incelemesi gerektirir.