Mimari En İyi Uygulamaları

Olay Güdümlü Webhook'lar ve Periyodik Durum Yoklaması

Modern Web3 ticaret altyapılarının sürekli API yoklaması yerine anlık kripto mutabakatı için neden HMAC SHA-256 imzalı webhook'lar kullandığını inceleyin.

Doğrudan Karşılaştırma Matrisi

Kriter REST API Yoklaması (GET /status) XPayr Webhook'u (POST Event)
Gecikme / Teslimat Hızı Aralık kadar gecikmeli (örn. 5-30 saniye) Anında (blokzincir onayında < 250 ms)
Sunucu Yükü ve Gelen Trafik Bant Genişliği Yüksek: Sipariş başına yüzlerce gereksiz GET isteği Minimum: Durum değişikliğinde tam olarak 1 POST isteği
İstek Sınırı (Rate Limit) Hassasiyeti Trafik artışlarında 429 Too Many Requests hatasına açık Sıfır: Gelen anlık bildirim (push) modeli istek sınırlarına takılmaz
İmza ve Güvenlik Kanıtı API Token Bearer Kimlik Doğrulaması HMAC-SHA256 Veri Özeti (Payload Hash) Doğrulaması

Kurumsal E-Ticaret İçin Önerilen Hibrit Mimari

Kritik üretim sistemleri için şu yapıyı kullanmanızı öneririz: Birincil Olarak Webhook'lar and Yedek Olarak Yoklama (Polling):

  1. Birincil (Anlık): Dijital indirmeleri, API anahtarlarını veya fiziksel gönderileri anında tamamlamak için payment.confirmed imzalı webhook olayını dinleyin.
  2. Güvenlik Ağı: Yalnızca 15 dakikadan eski olup henüz webhook onayı almamış siparişler için her 30 dakikada bir GET /api/v1/payments/{id}/status uç noktasını sorgulayan bir arka plan mutabakat görevi çalıştırın.
Webhook Doğrulama Rehberini Görüntüle → Etkileşimli Webhook Test Aracı MCP Oyun Alanında Durum Aracını Test Et OpenAPI Spesifikasyonunu Aç
Resmi NPM SDK'ları (v0.2.0) ve Uzak MCP Sunucusu

Resmi XPayr Paketleri ve Kurulumsuz MCP ile Daha Hızlı Entegre Olun

Kurulum: @xpayr/node-sdk (v0.2.0), @xpayr/payment-evidence (v0.2.0), @xpayr/extension-kit (v0.2.0)veya @xpayr/mcp-server (v1.0.0) paketlerini NPM'den yükleyin veya şu araçla canlı JSON-RPC 2.0 çağrıları yürütün: POST https://xpayr.com/api/mcp.

Canlı MCP Oyun Alanı (/tools/mcp-playground) ES256 Lisans Doğrulayıcı YZ Ajan Politikası Simülatörü HMAC-SHA256 Webhook Test Aracı mcp.xpayr.com docs.xpayr.com api-docs.xpayr.com