TEKNİK ENTEGRASYON

Geliştirici Merkezi

Kurumsal entegrasyonlar için API sözleşmeleri, kimlik doğrulama, webhooks, idempotency, hata yönetimi ve operasyon ilkeleri.

Entegrasyon sözleşmesi önce gelir

Uygulama geliştirmeden önce veri modeli, yetki sınırları, hata davranışı ve yeniden deneme kuralları tanımlanır.

Kimlik doğrulama
API anahtarları, imzalı istekler, token yaşam döngüsü ve yetki kapsamları proje mimarisine göre tanımlanır.

REST API
Kaynak odaklı uç noktalar, tutarlı durum kodları, sürümleme ve geriye dönük uyumluluk ilkeleri.

WebSocket
Gerçek zamanlı olay akışları için bağlantı yaşam döngüsü, yeniden bağlanma ve sıra bütünlüğü yaklaşımı.

Webhook
İmzalı bildirimler, yeniden deneme, teslimat kimliği ve yinelenen olaylara karşı güvenli işleme.

İdempotency
Ödeme, emir ve işlem gibi kritik yazma operasyonlarında yinelenen isteklere karşı güvenli tasarım.

Hata modeli
Makine tarafından işlenebilir hata kodları, correlation ID ve destek ekipleri için izlenebilirlik.

Hız sınırları
İstemci davranışını öngörülebilir tutmak için kota, backoff ve kontrollü yeniden deneme prensipleri.

Gözlemlenebilirlik
Log, metrik, trace ve olay kimlikleriyle entegrasyon sorunlarının uçtan uca incelenebilmesi.

Örnek API sözleşmesi

Örnekler temsili entegrasyon modelini gösterir; gerçek uç noktalar proje sözleşmesine göre tanımlanır.

POST /v1/transactions
Idempotency-Key: <unique-key>
Authorization: Bearer <token>

{
  "reference": "client-reference",
  "asset": "ASSET",
  "amount": "100.00"
}

Teknik kapsamı görüşelim

TEMSİLİ API SÖZLEŞMESİ

Entegrasyon davranışı belirsiz bırakılmaz.

Aşağıdaki yapı temsili bir sözleşme modelidir; gerçek endpoint ve şemalar proje sözleşmesinde tanımlanır.

REQUEST

POST /v1/transactions
Authorization: Bearer <token>
Idempotency-Key: <unique-key>

{
  "reference": "client-reference",
  "asset": "ASSET",
  "amount": "100.00"
}

ERROR MODEL

{
  "error": {
    "code": "POLICY_REJECTED",
    "message": "Request rejected",
    "request_id": "req_..."
  }
}

WEBHOOK

event: transaction.updated
signature: <signed-header>
delivery_id: <unique-id>

verify → persist → process → 2xx