النمط العالمي لتكامل أي API
قالب مرجعي يربط العقد الخمس العالمية في المسار الذهبي: ويب هوك ← مدقق ← اتصال HTTP (مع إعادة المحاولة) ← تحويل ← حارس عدم التكرار ← الإجراء الجانبي ← رد الويب هوك. انسخ واستبدل HTTP بأي مزود.
خطوات التدفق
- Webhook Trigger (any system)
- Validate Payload + Signature
- Try / Catch (resilience scope)
- Catch: Log Vendor Failure
- Retry x3 (exponential backoff)
- HTTP: Call Vendor API (replace me)
- Transform: Vendor → Universal Shape
- Idempotency Guard (correlation ID)
- Side-Effect (replace with your action)
- Webhook Response 200
- Optional: Human Approval Gate