Açık ağ ve harici entegrasyonlar

(Bölüm: Ekosistem ve Ağ)

1) Neden açık ağ

Açık ağ, entegrasyonların işlem maliyetlerini azaltır ve inovasyonu hızlandırır. Standartlaştırılmış sözleşmeler, sanal alanlar ve self servis portallar, ekosistemi, katılımcıların her adımda koordinasyon olmadan hızla değer yarattıkları bir "geliştirme platformu'na dönüştürüyor.

2) Openliğin ilkeleri

Tasarıma göre aç: genel API/olay özellikleri, örnekler, SDK.
Önce güvenlik ve gizlilik: minimum gerekli veriler, imzalar, PII lokalizasyonu.
Geriye/ileriye uyumluluk: sürüm ve geçiş politikası.
Varsayılan olarak gözlemlenebilirlik: uçtan uca trace-id, yapılandırılmış günlükler, metrikler.
Self servis: anahtarlar, webhook'lar, kotalar ve raporlama - portal üzerinden.
Maliyet bilincinde: çıkış limitleri, önbellekleme, ekonomik koruma rayları.

3) Entegrasyon sözleşmeleri

3. 1 API (RQ/RS)

Biçim: REST/gRPC + belirtimi (OpenAPI/Protobuf).
Gerekli başlıklar: 'x-request-id', 'x-idempotency-key', 'traceparent'.
Hatalar: deterministik kodlar, retray ipuçları, referans 'status _ url' asenkron için.

3. 2 Etkinlikler (Pub/Sub)

Поля: 'event _ id', 'occured _ at', 'producer', 'subject _ id', 'schema _ version', 'region', 'tenant'.
Garantiler: en az bir kez, anahtarla bölümleme (user_id/tenant_id), tekrar oynatma için tutma.

3. 3 Webhooks

Başlıklar: 'imza', 'zaman damgası', 'nonce', 'teslim-id'.
Anti-replay: TTL pencereler, bir kerelik 'nonce', kullanılan 'delivery-id' listesi.
Davranış: 2xx = alım; jitter ile üstel retrai; Alıcıda idempotency.

4) Güvenlik ve güven

Kimlik doğrulama: İstemci entegrasyonları için OAuth2/OIDC, S2S için mTLS.
İmzalar: HMAC/Ed25519; Merkezi anahtar dizini, döndürme ve sabitleme.
Erişim politikaları: RBAC/ABAC, "minimum düzeyde yeterli" kapsamlar, geçici belirteçler.
Anahtarlar ve sırlar: Bölge başına KMS, görev ayrımı (kritik işlemler için M-of-N).
Denetim: değişmez günlükler (WORM) + Merkle dilimleri ve makbuzları (makbuzlar).

5) Sürüm ve göçler

API'ler ve olay şemaları için SemVer.
Strategy: expand, migrate, contract (alan ekle, tüketicileri çevir, eskileri sil).
Takvimdeki son sürümler, GA öncesi ve GA pencereleri, test yayınları.
CI'da otomatik uyumluluk kontrolleri; Sertifikalı entegrasyonlar için'yeşil onay ".

6) Sandbox, SDK ve DevEx

Sandbox: test anahtarları, düzeltmeler, sahte ödemeler, olay üreteçleri ile tam teşekküllü bir ortam.
SDK/CLI: hızlı entegrasyon, teknik özelliklere göre istemciler oluşturma, kopyala-yapıştır örnekleri.
Sözleşme kataloğu: etki alanlarına, sürümlere, bölgelere göre arama; Changelog ve payload örnekleri.
Otomatik sertifikasyon: imzalar, idempotence, şemalar için test paketi; Uyumluluk rozetleri.

7) SLO/SLA, kotalar ve adil kullanım

Kanal başına SLO: p95/p99 gecikme, hata oranı, olay teslimatlarının başarısı.
Ortaklar için SLA'lar: hedef kullanılabilirlik pencereleri, kod olarak kredi notları/cezalar.
Kotalar/sınırlar: anahtar başına/kiracı/bölge, patlama parametreleri, seviyeye göre öncelikler.
Hız sınırları ve koruma: devre kesiciler, geri basınç, kill-switch.
Maliyet bilincine sahip yönlendirme: eşit gecikmeyle, daha ekonomik bir şekilde.

8) Gözlemlenebilirlik ve denetim

İzlenebilirlik: Tüm kanallarda (RPC, etkinlikler, web kitapları) uçtan uca 'trace _ id'/' span _ id'.
Metrikler: gecikme p50/p95/p99, hata oranı, kuyruk gecikmesi, önbellek isabetleri, çıkış/giriş.
Günlükler: yapılandırılmış, 'tenant _ id', 'partner _ id', sözleşme sürümü ve bölgesi ile.
Makbuzlar ve Merkle kayıtları: kanıtlanabilir teslimat/dahil etme; Otomatik uzlaştırmalar (diff).
İş ortağı panoları: tüketim, teslimat durumları, kotalar, olaylar, faturalandırma.

9) Uyumluluk ve gizlilik

Veri minimizasyonu: Olaylar ekstra PII değil, tanımlayıcılar/ispatlar taşır.
Veri yerelleştirme: PII/finansal veriler - bölgenin "güven bölgelerinde"; dış - belirteçler/hash'ler.
Unutulma hakkı: Birincil PII'lerin kanıtlanabilirlik kaybı olmadan kaldırılması (makbuzlar kalır).
Kod olarak politikalar: Serbest bırakma kapılarını engelleyen CI gizlilik/güvenlik kontrolleri.

10) Ortak onboarding (referans akışı)

1. Durum Tespiti: Güvenlik/Uyumluluk, SLA/Ekonomi Uyumu.
2. Anahtar verme: kapsamlar, kotalar, geçici erişim.
3. Sandbox entegrasyonu: yük örnekleri, otomatik sertifikasyon.
4. Ficheflag altında Pilot: sınırlı trafik, korkuluklar ve panolar.
5. GA başlatma: katalogda yayınlanma, SLA koşulları/faturalandırma.
6. Operasyon: izleme, raporlar, düzenli incelemeler; sürüm oluşturma/geçiş.
7. EOL/sonlandırma: anahtar iptali, trafik geçişi, eser arşivi.

11) Uzatma Pazarı

Biçim: Vitrin, derecelendirme ve koşullara sahip eklentiler/adaptörler/botlar.
Gelir modeli: telif ücretleri/kullanım ücretleri, büyük entegratörler için kademe indirimleri.
Kalite: sertifikasyon, SLO rozetleri, güncellemeler için otomatik uyumluluk kontrolleri.
Güvenlik: eser imzalama (SBOM), güncelleme ve geri alma politikası.

12) Etkileşim ekonomisi

RevShare/CPA/CPL/Marketplace komisyonları - raporlama planlarında şeffaf ve resmileştirilmiş.
Paylaşılan tasarruflar: Hisse tasarrufları (örneğin, çıkışın/ters ibrazın azaltılması).
Budget-cap: promo/intent limitleri, auto-downscale çarpanları.
Anlaşmazlık ve emanet: imzalı makbuzlarda otomatik tahkim, geçici emanet.

13) Riskler ve anti-kalıplar

Sürüm kaosu: Bir göç politikasının olmaması tüketicileri kırıyor.
Webhook'ların zayıf güvenliği: imza yok/TTL/nonce - dolandırıcılık/tekrarlar.
Idempotence eksikliği: çift ödeme/tahakkuk.
Aşırı kilolu PII: gizlilik ihlali ve artan uyum maliyetleri.
Kill-switch ve kotalar yoktur: bir ortak kapasiteyi "sıkar", maliyetler artıyor.
Opak faturalandırma: tartışma ve güven kaybı.

14) Açık Ağ Başarı Metrikleri

DevEx: TTFI (key-to-first-success), sertifikasyon süresi, NPS entegratörleri.
Kalite: Kanallar üzerinden p95/p99, webhook teslimat başarısı, replikasyon gecikmesi.
Ekonomi: 1k olayların maliyeti, ortak başına çıkış/giriş, teşvik programlarının yatırım getirisi.
Güvenilirlik: MTTR, idempotently işlenmiş kopyaların payı, makbuzların kapsadığı işlemlerin payı.
Ağ etkileri: Aktif entegrasyonların sayısı, standartlaştırılmış veri yolu üzerinden trafiğin payı.

15) Uygulama kontrol listesi

• API/olay özelliklerini ve sürüm kataloğunu yayınlayın.
• Sandbox, SDK/CLI ve otomatik sertifikasyonu etkinleştirin.
• Yapılandırma OAuth2/OIDC ve mTLS, webhook imzaları (HMAC/Ed25519), TTL/nonce.
• Her yere 'x-idempotency-key', 'traceparent', 'x-request-id' girin.
• Merkle günlüklerini ve makbuzlarını çalıştırın; İş ortağı panoları ve faturalandırma.
• SLO/SLA, kotalar, oran limitleri, maliyet farkında yönlendirme ve kill-switch'i tanımlayın.
• Genişletmeyi kabul edin - göç edin - sözleşme politikası ve kırılma takvimi.
• Resmileştirme ekonomisi (RevShare/CPA/Marketplace/Shared-savings) ve anlaşmazlık/emanet kuralları.
• PII/finansal verileri yerelleştirmek; CI'da - gizlilik/güvenlik denetleyicileri.
• Düzenli GameDays entegrasyonları yapın (yeniden ödeme fırtınası, imza kaybı, sürüklenme şemaları).

16) SSS

Onboarding nasıl hızlandırılır?
Sandbox + hazır SDK'lar, sözleşme otomatik sertifikasyonu ve webhook'lar için durum uç noktaları.

Breaking releases nasıl önlenir?
Sıkı SemVer, uyumluluk modu ve Pre-GA pencereleri ile "genişlet - geçir - sözleşme".

İmzalı telemetriye ihtiyacım var mı?
Kritik iş işlemleri için, evet (makbuzlar/imzalar). Metrikler için korelasyon ve hash yeterlidir.

"Almak'ile ne yapmalı?
Idempotent anahtarları, alıcıda veri tekilleştirme ve repeat-safe işleyicileri.

Özet: Açık bir ağ, standartların ve disiplinin bir birleşimidir: özellikler ve sanal alanlar, imzalar ve idempotency, kotalar ve maliyet bilincine sahip politikalar, gözlemlenebilirlik ve kanıtlanabilir denetim, net göçler ve adil bir ekonomi. Bu kontrol listesini takip ederek, ekosistem hızlı entegrasyonlar, öngörülebilir kalite ve sürdürülebilir büyüme elde eder.