الخلاصة استخدم Native WebSocket للتواصل البسيط في الوقت الفعلي مع المتصفحات الحديثة. استخدم Socket.IO عندما تحتاج إلى إعادة اتصال تلقائية، أو وسائل نقل احتياطية، أو غرف/مساحات أسماء (namespaces). يضيف Socket.IO حملاً زائداً يزيد عن 200 كيلوبايت ولكنه يتعامل مع الحالات الهامشية. تطبق PetstoreAPI الحديثة كليهما: Native WebSocket للمزادات، و Socket.IO للدردشة. مقدمة أنت بحاجة إلى اتصال ثنائي الاتجاه في الوقت الفعلي. هل يجب عليك استخدام Native WebSocket أم Socket.IO؟ يتوفر Native WebSocket مدمجً

Ashley Innocent

مارس 13, 2026

خلاصة القول استخدم أحداث المرسل من الخادم (Server-Sent Events - SSE) للتحديثات أحادية الاتجاه من الخادم إلى العميل مثل الإشعارات والخلاصات المباشرة. استخدم WebSocket للاتصال ثنائي الاتجاه مثل الدردشة والألعاب. SSE أبسط ويعمل عبر HTTP. WebSocket أكثر تعقيدًا ولكنه يدعم المراسلة ثنائية الاتجاه. تُطبق واجهة برمجة تطبيقات Modern PetstoreAPI كلاهما لحالات استخدام مختلفة في الوقت الفعلي. مقدمة تحتاج إلى تحديثات في الوقت الفعلي في واجهة برمجة التطبيقات (API) الخاصة بك. يتغير حالة حيوان أليف من "متا

Ashley Innocent

مارس 13, 2026

ملخص سريع (TL;DR) استخدم MQTT لأجهزة إنترنت الأشياء (IoT) ذات البطارية المحدودة، والشبكات غير الموثوقة، أو أنماط المراسلة من نوع النشر والاشتراك (pub-sub). استخدم HTTP لواجهات برمجة التطبيقات (APIs) القياسية للويب/الجوال. يستخدم MQTT رؤوسًا بحجم 2 بايت مقابل أكثر من 100 بايت في HTTP، مما يجعله مثاليًا للأجهزة ذات الموارد المحدودة. تطبيق Modern PetstoreAPI الحديث يطبق MQTT لأطواق تتبع الحيوانات الأليفة وأجهزة التغذية الذكية. مقدمة يحتاج طوق تتبع حيوانك الأليف إلى إرسال تحديثات الموقع كل 5 دقا

Ashley Innocent

مارس 13, 2026

ملخص سريع بروتوكول سياق النموذج (MCP) هو معيار لربط المساعدين المدعومين بالذكاء الاصطناعي بمصادر البيانات الخارجية وواجهات برمجة التطبيقات (APIs). يسمح لـ Claude Desktop و Cursor وأدوات الذكاء الاصطناعي الأخرى بالوصول إلى واجهة برمجة التطبيقات الخاصة بك بشكل آمن. تُطبّق Modern PetstoreAPI بروتوكول MCP بحيث يمكن للمساعدين المدعومين بالذكاء الاصطناعي البحث عن الحيوانات الأليفة وتقديم الطلبات وإدارة المخزون من خلال اللغة الطبيعية. مقدمة تسأل Claude Desktop: "أرني القطط المتاحة بأقل من 300 دولار

Ashley Innocent

مارس 13, 2026

ملخص سريع تستخدم واجهات برمجة التطبيقات المعتمدة على الأحداث (Event-driven APIs) خطافات الويب (webhooks) للإشعارات الخارجية وقوائم انتظار الرسائل للمعالجة الداخلية. قم بنشر الأحداث إلى قائمة انتظار (RabbitMQ, Kafka)، ومعالجتها بشكل غير متزامن، وإبلاغ العملاء عبر خطافات الويب. تستخدم PetstoreAPI الحديثة هذا النمط لمعالجة الطلبات، وتحديث المخزون، وإشعارات الدفع. مقدمة يضع العميل طلبًا. تحتاج واجهة برمجة التطبيقات (API) الخاصة بك إلى تحصيل الدفع، وتحديث المخزون، وإرسال بريد إلكتروني، وإخطار الم

Ashley Innocent

مارس 13, 2026

موجز استخدم الأحداث المرسلة من الخادم (SSE) لتدفق استجابات واجهة برمجة التطبيقات عبر HTTP. أرسل Content-Type: text/event-stream واكتب الأحداث كـ data: {json}\n\n. تعمل SSE لتدفق استجابات الذكاء الاصطناعي، وتحديثات التقدم، والموجزات المباشرة. تستخدم واجهة برمجة تطبيقات متجر الحيوانات الأليفة الحديثة (Modern PetstoreAPI) SSE لتوصيات الحيوانات الأليفة بالذكاء الاصطناعي وتحديثات حالة الطلب. مقدمة تُنشئ واجهة برمجة التطبيقات الخاصة بك توصيات حيوانات أليفة بالذكاء الاصطناعي. تستغرق الاستجابة 10 ثو

Ashley Innocent

مارس 13, 2026

تلخيص سريع صمم Webhooks موثوقة باستخدام إعادة المحاولة بأسلوب التراجع الأُسي (5-10 محاولات)، ومفاتيح المعاودة الآمنة، والتحقق من توقيع HMAC، ومهلات 5 ثوانٍ. أعد استجابة 2xx فورًا، وقم بالمعالجة بشكل غير متزامن. تطبق PetstoreAPI الحديثة Webhooks لتحديثات الطلبات، وعمليات تبني الحيوانات الأليفة، وإشعارات الدفع مع إعادة محاولة وأمان كاملين. مقدمة ترسل Webhook لإخطار عميل بأن حيوانه الأليف قد تم تبنيه. خادم العميل معطل. يفشل الـ Webhook الخاص بك. هل تعيد المحاولة؟ كم مرة؟ وماذا لو استلم العميل ا

Ashley Innocent

مارس 13, 2026

خلاصة القول نطاقات OAuth 2.0 هي سلاسل صلاحيات تحدد ما يمكن أن يفعله رمز الوصول. استخدم التنسيق المورد:الإجراء مثل pets:read أو orders:write. اطلب النطاقات أثناء التفويض، وتحقق منها على نقاط نهاية API. تطبق Modern PetstoreAPI نطاقات للوصول بالقراءة/الكتابة إلى الحيوانات الأليفة والطلبات وبيانات المستخدم. مقدمة يرغب تطبيق تابع لجهة خارجية في قراءة مخزون متجر الحيوانات الأليفة الخاص بك. هل يجب أن يكون لديه وصول كامل لإنشاء الطلبات وحذف الحيوانات الأليفة وإدارة المستخدمين؟ لا. يجب أن يقرأ المخزو

Ashley Innocent

مارس 13, 2026

TL;DR استخدم REST لواجهات برمجة التطبيقات العامة وعمليات CRUD البسيطة. استخدم GraphQL عندما يحتاج العملاء إلى جلب بيانات مرن وترغب في تقليل الجلب الزائد. استخدم gRPC لاتصالات الخدمات المصغرة عالية الأداء. ينفذ PetstoreAPI الحديث جميع البروتوكولات الثلاثة، مما يتيح لك اختيار الأداة المناسبة لكل حالة استخدام. مقدمة أنت تبني واجهة برمجة تطبيقات (API). هل يجب عليك استخدام REST أو GraphQL أو gRPC؟ لكل بروتوكول مؤيدون متحمسون يدعون أن بروتوكولهم هو الأفضل. الحقيقة: جميعها جيدة في أشياء مختلفة. RE

Ashley Innocent

مارس 13, 2026

باختصار أضافت OpenAPI 3.1 التوافق الكامل مع JSON Schema، وwebhooks، وتحسينات على الـ discriminator. أضافت OpenAPI 3.2 دعم طريقة QUERY، وأمثلة محسنة، وتعاريف أمان أفضل. يستخدم Modern PetstoreAPI الإصدار 3.2 من OpenAPI لعرض أحدث الميزات مع أمثلة جاهزة للإنتاج. مقدمة أنت تكتب مواصفات OpenAPI. ترى إشارات إلى OpenAPI 3.0 و 3.1 و 3.2. ما الفرق؟ هل يجب عليك الترقية؟ هل ستدعم أدواتك الإصدار الجديد؟ تطورت OpenAPI بشكل كبير من 3.0 إلى 3.2. يضيف كل إصدار ميزات تجعل مواصفات API أكثر قوة ودقة. ولكن ليست

Ashley Innocent

مارس 13, 2026

ملخص سريع ابنِ واجهات برمجة تطبيقات (APIs) متعددة البروتوكولات عن طريق فصل منطق الأعمال عن طبقات البروتوكول. أنشئ طبقة نطاق (domain layer) مشتركة، ثم أضف عليها محولات REST و GraphQL و gRPC. يوضح Modern PetstoreAPI هذه البنية بنماذج بيانات متسقة عبر جميع البروتوكولات الثلاثة. مقدمة تعمل واجهة برمجة التطبيقات (API) الخاصة بك على خدمة عملاء الويب وتطبيقات الجوال والخدمات المصغرة الداخلية. يريد عملاء الويب REST للبساطة. ترغب تطبيقات الجوال في GraphQL لتقليل نقل البيانات. تريد الخدمات المصغرة gRP

Ashley Innocent

مارس 13, 2026

هل يجب على واجهات برمجة تطبيقات REST تطبيق روابط الوسائط الفائقة (HATEOAS)؟ TL;DR HATEOAS (الوسائط الفائقة كمحرك لحالة التطبيق) أنيق نظريًا ولكنه معقد عمليًا. تتجاوز معظم واجهات برمجة التطبيقات تطبيق HATEOAS الكامل وتستخدم روابط وسائط فائقة انتقائية للترقيم والموارد ذات الصلة والإجراءات. تطبق PetstoreAPI الحديثة روابط وسائط فائقة عملية دون إجبار العملاء على أن يكونوا مدفوعين بالوسائط الفائقة بالكامل. مقدمة أنت تقرأ عن تصميم واجهات برمجة تطبيقات REST. ستصادف HATEOAS (الوسائط الفائقة كمحرك ل

Ashley Innocent

مارس 13, 2026

ملخص قم بتطبيق تحديد معدل استدعاءات API باستخدام خوارزميات سلة الرموز (token bucket) أو النافذة المنزلقة (sliding window). أرجع رؤوس (headers) تحديد المعدل القياسية لـ IETF (RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset) و 429 Too Many Requests عند تجاوز الحدود. Modern PetstoreAPI يطبق تحديد المعدل مع حصص مخصصة لكل مستخدم واستجابات خطأ واضحة. مقدمة يقوم عميل واحد بإجراء 10,000 طلب إلى واجهة برمجة التطبيقات (API) الخاصة بك في دقيقة واحدة. يتعطل خادم قواعد البيانات الخاص بك. تنطلق تنبي

Ashley Innocent

مارس 13, 2026

ملخص ترقيم الإصدارات في عنوان URL (/v1/pets) هو استراتيجية ترقيم إصدارات واجهة برمجة التطبيقات (API) الأكثر عملية لمعظم الفرق. إنه مرئي، قابل للتخزين المؤقت، وسهل الاختبار. ترقيم الإصدارات في الرأس (Header versioning) وتفاوض المحتوى (content negotiation) أكثر "نقاءً" من منظور REST ولكنهما يضيفان تعقيدًا. تستخدم PetstoreAPI الحديثة ترقيم الإصدارات في عنوان URL مع الترقيم الدلالي للإصدارات وسياسات واضحة للإيقاف التدريجي. مقدمة تحتاج واجهة برمجة التطبيقات (API) الخاصة بك إلى تغيير مؤثر (breakin

Ashley Innocent

مارس 13, 2026

خلاصة بالنسبة لمجموعات البيانات الكبيرة، استخدم ترقيم الصفحات المعتمد على المؤشر (cursor-based) أو المعتمد على المفاتيح (keyset) بدلاً من ترقيم الصفحات المعتمد على الإزاحة (offset-based). ترقيم الصفحات بالإزاحة (?page=1&limit=20) يؤدي أداءً سيئًا مع ملايين السجلات ويسمح بعدم اتساق البيانات. تطبق PetstoreAPI الحديثة ترقيم الصفحات المعتمد على المؤشر باستخدام رموز غير شفافة وروابط HATEOAS للحصول على نتائج فعالة ومتسقة. مقدمة تقوم واجهة برمجة التطبيقات (API) الخاصة بك بإرجاع قائمة من الحيوانات ا

Ashley Innocent

مارس 13, 2026