بوابة API والتوجيه

1) دور بوابة API في الهندسة المعمارية

• طلبات المسارات (حسب المسار/الرؤوس/الجغرافيا/الوزن/النسخة).
• يحمي المحيط (TLS/mTLS، WAF، DDoS، حدود المعدل، authN/Z).
• يتحكم في حركة المرور (الكناري/AB، الظل/المرآة، قاطع الدائرة، retras، المهلات).
• توحيد البروتوكولات (REST/gRPC/WebSocket)، الرؤوس، الرموز.
• ملاحظات (سجلات، مقاييس، آثار، ارتباط).
• التحويلات والتحقق (JSON/XML، التطبيع، التحقق من صحة المخطط).

بالنسبة إلى iGaming، فهو أيضًا امتثال جغرافي (حظر البلد/العمر)، وتوجيه الدفع الذكي وسياسات الألعاب المسؤولة على الحافة.

2) خيارات التوجيه

على أساس المسار: «/api/v1/payments/ → payments-svc ».
القائم على المضيف: 'eu. api. مثال على ذلك. com → eu-edge '،' psp. مثال على ذلك. com → psp-proxy '.
قائمة على العنوان: «X-Client: partner-A» → الشريك الخلفي ؛ «قبول: طلب/grpc».
التوجيه الجغرافي: حسب IP/ASN/country (GDPR/local brombers, latency).
المرجح/الكناري: «90٪» على القديم، «10٪» على الإصدار الجديد ؛ التراجع السريع.
توجيه المطالبات: по 'JWT. . المستوى/الدور/المنطقة '(على سبيل المثال، الحدود القصوى → الأقساط).
الفشل: الأصول والأصول/الأصول والخصوم بين مركز البيانات/السحابة و PSP.

3) أمن المحيط

TLS في كل مكان: TLS 1. 2 + على الجزء الخارجي، mTLS بالداخل (shlyuz↔servisy).
OAuth2/JWT: التحقق من التوقيع، مراجعة الحسابات 'exp/nbf/aud/scope'، تناوب JWKS ؛ مخبأ التحقق مع TTL.
HMAC: توقيع الجسم لخطابات الويب/المدفوعات.
مفاتيح واجهة برمجة التطبيقات: لعملاء النظام ؛ مع الحصص/الأدوار.
WAF: القواعد الأساسية (الحقن، شذوذ البروتوكول)، حجم الجسم، رفض قائمة البلدان.
حماية DDoS: الحد من الاتصال، ملفات تعريف الارتباط SYN، حد المعدل على IP/key/endpoint.
صفر الثقة: السياسات الإلزامية (SPIFFE/SPIRE، هويات الخدمة)، مبدأ أقل الحقوق.
الخصوصية: تحرير PII في السجلات، وإخفاء PAN/IBAN، وسياسة التخزين.

4) الحدود والحصص والحماية من الرشقات النارية

Модели: دلو رمزي، دلو متسرب، نافذة ثابتة/منزلقة.
الحدود: لكل IP، لكل مفتاح، لكل مستخدم، لكل مسار.

• انفجار + مستدام (على سبيل المثال «انفجار 50 rps»، «10 rps sustainable»).
• Retry-Budget and Slow-Loris protection (اقرأ المهلة).
• حصة كل يوم/شهر للشركاء.

5) التحويلات والتحقق

تطبيع الرؤوس (التعقب، الموقع، معرف العميل).
الطلب/رسم خرائط الاستجابة.
التحقق من صحة المخطط (OpenAPI/JSON Schema) قبل التوكيل - فشل 4xx المبكر.
Compression/' Accept-Encoding ', cacking (انظر أدناه).

6) التخزين المؤقت والأداء

Edge cache for directories, public metadata, conficts (TTL, 'ETag '/' If-None-Match').
Micro-cache 1-5 s لـ GET الساخن (يقلل من ذروة الحمل).
مخبأ سالب قصير (404/فارغ) - حذر.
طلبات التحوط والطلبات التنافسية للنسخ المتماثلة عند العتبة p95>.

7) المهلة، التراجعات، المرونة

المهلة: الاتصال/القراءة/الكتابة بشكل منفصل ؛ معالم معقولة p95.
Retrai: طرق خفية (GET/PUT) مع backoff + jitter ؛ إعادة النظر في الميزانية.
POST impempotency: «Idempotency-Key» + خدمة/تفريغ البوابة.
قاطع الدائرة: بأخطاء/زمن انتقال ؛ نصف محاكمة مفتوحة.
Bulkhead/Pool-impolation by upstream.

8) الحرث والتوافق

• URI: '/v1/... (طرق بسيطة ولكن «صاخبة»).
• Header/Content-Contribution: 'Accept: application/vnd. app. v2 + json '.
• أعلام الميزات/قدرة الخادم - لتوافق التغيير الطفيف.

السياسة: SemVer، نافذة الدعم (على سبيل المثال، «v1» = 12-18 شهرًا)، جدول الاكتئاب، الاستجابات المتوافقة للتمديدات (إضافة الحقول لا تنكسر).

9) إمكانية الرصد ومراقبة الجودة

الارتباط المطلوب: 'traceparent '/' x-request-id' ؛ نحن رميها إلى أسفل.
OpenTelemetry: RPS/p50/p95/p99/5xx/4xx، التشبع، إعادة النظر/مقاييس حدث الدائرة.
الجذوع: هيكلية JSON ؛ وتنكر المبادرة ؛ المستويات بالرمز.
أخذ العينات النزرة: الهدف الأساسي للأخطاء/البطيئة 5-10٪ +.
SLO/التنبيهات: حسب الطرق/العملاء (وقت التشغيل، زمن الانتظار، الخطأ).

10) تحرير إدارة حركة المرور

مفتاح Blue-Green DNS/LB.
الكناري: حصة/قطاعات الوزن (المنطقة، الشريك، الدور).
Shadow/Mirror: نسخة من حركة المرور إلى الإصدار الجديد دون الرد على العميل.
Kill-switch: علم لتعطيل مشكلة المنبع/الميزة بسرعة.

11) توجيه الدفع الذكي (iGaming)

قواعد اختيار PSP: الجغرافيا والعملة والمبلغ ومعدل المخاطر والتوافر والعمولة.
Failover PSP: الانتقال التلقائي عند "5xx/timeout'.
قاعدة الطريقة نفسها: الإرجاع/المخرجات من خلال الطريقة الأصلية - تحقق من الحافة.
معرف الدفع: مفتاح «معرف المستخدم + المبلغ + العملة + الغرض».
شفافية ETA: تضيف البوابة حالات وأسباب الفشل (وليس رموز PSP).

12) السياسات والامتثال عبر المناطق

المرشحات الجغرافية: قوائم البلدان البيضاء/السوداء، والقيود العمرية، ونطاقات الملكية الفكرية.
بيانات المقيمين: التوجيه إلى المجموعات الإقليمية (اللائحة العامة لحماية البيانات/القوانين المحلية).
Logs and TTL: التخزين حسب المنطقة، إخفاء الهوية التلقائي.

13) أمثلة التكوين

13. 1 NGINX (التوجيه + الحد + الرؤوس)

nginx http {
map $http_x_request_id $req_id { default $request_id; }
limit_req_zone $binary_remote_addr zone=per_ip:10m rate=20r/s;

server {
listen 443 ssl http2;
server_name api. example. com;

Security add_header Strict-Transport-Security "max-age = 31536000" always;
add_header X-Content-Type-Options nosniff;

Limit on IP location/api/v1/{
limit_req zone=per_ip burst=40 nodelay;
proxy_set_header X-Request-Id $req_id;
proxy_set_header X-Client-Ip $remote_addr;
proxy_read_timeout 5s;
proxy_connect_timeout 1s;
proxy_pass http://payments_v1;
}

Canary traffic by header location/api/v2/{
if ($http_x_canary = "1") { proxy_pass http://payments_v2; }
proxy_pass http://payments_v1;
}
}
}

13. 2 مبعوث (JWT، الحد الأقصى للمعدل، الإعادات، الخارج)

yaml static_resources:
listeners:
- name: https address: { socket_address: { address: 0. 0. 0. 0, port_value: 443 } }
filter_chains:
- filters:
- name: envoy. filters. network. http_connection_manager typed_config:
"@type": type. googleapis. com/envoy. extensions. filters. network. http_connection_manager. v3. HttpConnectionManager route_config:
name: local_route virtual_hosts:
- name: payments domains: ["api. example. com"]
routes:
- match: { prefix: "/api/v1/payments" }
route:
cluster: payments_v1 timeout: 5s retry_policy:
retry_on: "connect-failure,refused-stream,5xx,retriable-status-codes"
num_retries: 2 per_try_timeout: 2s http_filters:
- name: envoy. filters. http. jwt_authn typed_config:
"@type": type. googleapis. com/envoy. extensions. filters. http. jwt_authn. v3. JwtAuthentication providers:
main:
issuer: "https://auth. example. com/"
remote_jwks: { http_uri: { uri: "https://auth. example. com/.well-known/jwks. json" } }
forward: true rules:
- match: { prefix: "/api/" }
requires: { provider_name: "main" }
- name: envoy. filters. http. ratelimit
- name: envoy. filters. http. router clusters:
- name: payments_v1 connect_timeout: 0. 5s type: STRICT_DNS lb_policy: ROUND_ROBIN load_assignment: { cluster_name: payments_v1, endpoints: [{ lb_endpoints: [{ endpoint: { address: { socket_address: { address: payments, port_value: 8080 }}}}]}] }
outlier_detection: { consecutive_5xx: 5, interval: 5s, base_ejection_time: 30s }

14) القوائم المرجعية

قبل إطلاق الطريق

• مخطط التوثيق (JWT/JWKS، المفاتيح، مخبأ TTL).
• تم تكوين المهلة/إعادة التصوير/الخصوصية.
• الحدود: لكل IP، لكل مفتاح، لكل مسار ؛ حصص الشركاء.
• التصديق على خطة الطلب/الاستجابة.
• جذوع الأشجار والآثار مع أقنعة PII.
• SLO/التنبيهات ولوحة القيادة.
• القواعد الجغرافية/الامتثال/التحقق من العمر.

المعاملات والمدفوعات

• PSP Smart Routing: Rules، Priority، Feilover.
• يتم فحص نفس الطريقة عند الحافة.
• حالات شفافة ورموز خطأ للعميل (لا يوجد رمز PSP خام).

الإصدارات

• كناري/AB و kill-switch، خطة التراجع.
• حركة المرور في الظل إلى الإصدار الجديد، مقارنة المقاييس.
• اختبار الأحمال والأهداف p95.

15) مقاييس الجودة (الحد الأدنى)

'1' التوافر/المدار الخارجي حسب الطرق ؛ معدل الخطأ 5xx/4xx.
الكمون p50/p95/p99 (خارجي وداخلي).
Retry/timeout/circuit events (مستوى الضوضاء).
نسبة إصابة المخبأ ومدخرات RPS.
ضربات حد المعدل والطلبات المنخفضة.
PSP-routing KPIs: نجاحات، TtW، النسبة المئوية من feilover، العمولة.

16) الأنماط المضادة

حد إجمالي واحد «لكل شيء».
تراجعات «فورية» بدون نفحة (اشتداد العاصفة).
Trust' X-Forwered-For "بدون تطبيع وقائمة وكيل موثوقة.
مهلة صعبة باستثناء p95 (إيجابيات خاطئة).
التحولات الصعبة التي تكسر التوافق.
سجلات مع PII/PAN/أسرار.
مزج واجهة برمجة التطبيقات الداخلية والخارجية في نفس المجال/السياسة.

17) أنماط وأخطاء الاستجابة (ميكروكوب)

429 طلبات كثيرة جدًا: "تم الوصول إلى حد الطلب. تكرار الحصة في مكتب الشريك أو زيادتها في الثواني الجديدة"

401/403: "الرمز غير صالح/منتهي الصلاحية. يرجى تسجيل الدخول مرة أخرى"

408/504: "الخدمة تستجيب لفترة أطول من المتوقع. ولم يقبل الطلب"

Idempotency-conflict: «تمت بالفعل معالجة طلب بهذا المفتاح (الحالة: النجاح/الفشل)».

18) عملية التنفيذ (الخطوات)

1. نموذج الطريق: المجال/المسار/خريطة المنطقة.
2. السياسات الأمنية: TLS/mTLS، WAF، authN/Z، المفاتيح/JWKS.
3. الموثوقية: المهلة، إعادة التدوير، الخصوصية، قاطع الدائرة.
4. إمكانية الرصد: السجلات/المقاييس/الآثار، الارتباط.
5. Cache/perf: edge/micro-cache، الضغط، برك الاتصال.
6. توجيه الدفع: القواعد والاختبارات والمراقبة.
7. الإصدارات: كناري/ظل، مفتاح القتل، خطة التراجع.
8. الامتثال/الجغرافي: المرشحات القطرية، وتخزين البيانات، والعمر.

ورقة الغش النهائية

محيط صارم (TLS/mTLS، WAF، حدود) + حركة المرور المدارة (retrai، circuit، canary).
التحقق من الصحة والتحولات على حافة → أقل من عيوب «في الداخل».
القابلية للمراقبة باستخدام أقنعة التعرف النصيف و PII ليست خيارًا، ولكنها معيار.
يعد توجيه الدفع الذكي والامتثال الجغرافي أمرًا بالغ الأهمية لـ iGaming.
سياسة التحرير والحرمان - إمكانية التنبؤ للشركاء.