انتقل إلى المحتوى
KnowledgeCity

استخدامات واجهات REST API

تعرف على كيفية استخدام وثائق OpenAPI وتنفيذ العمليات الشائعة
شاهد الدرس الأول مجانًا — احصل على وصول كامل إلى جميع الدروس الـ4.
دورة تدريبية: عند الطلب
مبتدئ مقدِّم الخدمة Josh Guardino  4 الدروس ·  24m  باللغات: العربية, الألمانية, الإنجليزية, الإسبانية, الفرنسية, البرتغالية, Chinese 

وصف الدورة

REST هو أسلوب معماري لواجهة برمجة التطبيقات يعتمد بشكل كبير على معايير الصناعة بالإضافة إلى المفاهيم الأساسية الجوهرية التي تدعم الإنترنت. يسمح هذا الأسلوب بأنماط استخدام شائعة وقابلة للتكرار ويتناسب مع المعايير المقبولة على نطاق واسع للوصول إلى واجهة برمجة التطبيقات والتوثيق. توجد العديد من الوحدات النمطية والقوالب المعبأة مسبقًا لواجهات برمجة تطبيقات RESTولكن من الممكن أيضًا - وهو أمر شائع في الواقع - إنشاء واجهات برمجة تطبيقات REST من البداية.

توجد العديد من تنسيقات وثائق API ولكن الأكثر شيوعًا وربما الأسهل في الاستخدام يسمى OpenAPI. يسمح لمالكي REST APIs بنشر وثائق تفاعلية يتم إنشاؤها تلقائيًا بناءً على إمكانيات واجهة برمجة التطبيقات. سوف تتعلم كيفية قراءة وثائق OpenAPI وتشغيل اختبارات API مباشرة منه.

تتم تغطية الأنواع الأكثر شيوعًا من إجراءات API وطرق HTTPبما في ذلك عمليات القراءة باستخدام طريقة GET وإرسال العمليات باستخدام طريقة POST وطرق التحديث باستخدام طرق PUT وPATCH وDELETE.

ما ستتعلمه

  • وصف غرض وتنسيق توثيق OpenAPI، بما يشمل كيفية قراءته وتشغيل اختبارات API مباشرةً منه
  • سرد أكثر أساليب HTTP استخداماً مع واجهات برمجة التطبيقات REST ووصفها
  • تنفيذ عمليات القراءة من خلال فهم كيفية حصول طلبات GET على بيانات من واجهات برمجة التطبيقات REST
  • إرسال البيانات وتحديثها من خلال تحديد كيفية تمرير طلبات الكتابة لأجسام الطلبات إلى واجهات برمجة التطبيقات REST
  • استخدام طلبات POST لإرسال العمليات إلى واجهات برمجة التطبيقات REST
  • تحديث حالة الكائن باستخدام أساليب PUT وPATCH وDELETE

النقاط الرئيسية

  • REST أسلوب معماري لواجهات برمجة التطبيقات يعتمد على المعايير الصناعية والمفاهيم الأساسية التي تُشغّل الإنترنت، مما يُتيح أنماط استخدام شائعة وقابلة للتكرار.
  • يمكن بناء واجهات برمجة التطبيقات REST باستخدام وحدات وقوالب جاهزة، غير أن إنشاءها من الصفر أمر شائع أيضاً.
  • OpenAPI هو تنسيق توثيق API الأكثر شيوعاً والأسهل استخداماً على الأرجح، ويتيح لأصحاب واجهات REST API نشر توثيق تفاعلي يُنشأ تلقائياً استناداً إلى قدرات API.
  • يُستخدم GET لعمليات القراءة، وPOST لعمليات الإرسال، وPUT وPATCH وDELETE لعمليات التحديث.
  • تُرسل طلبات الكتابة أجسام الطلبات إلى واجهات برمجة التطبيقات REST، بينما تستقبل طلبات GET البيانات منها.

الأسئلة الشائعة

ما الذي يغطيه هذا المقرر؟

يغطي المقرر الأسلوب المعماري لواجهات REST API، وكيفية قراءة توثيق OpenAPI وتشغيل اختبارات API منه، وأكثر إجراءات API وأساليب HTTP انتشاراً، بما يشمل GET لعمليات القراءة وPOST لعمليات الإرسال وPUT وPATCH وDELETE لعمليات التحديث.

ما أساليب HTTP التي ستتعلمها؟

يغطي المقرر أكثر أساليب HTTP استخداماً، بما يشمل أسلوب GET لقراءة البيانات، وأسلوب POST لإرسال البيانات، وأساليب PUT وPATCH وDELETE لتحديث حالة الكائن.

ما OpenAPI وكيف يُستخدم في هذا المقرر؟

OpenAPI هو تنسيق توثيق API الأكثر شيوعاً، إذ يتيح لأصحاب واجهات REST API نشر توثيق تفاعلي يُنشأ تلقائياً استناداً إلى قدرات API. في هذا المقرر ستتعلم كيفية قراءة توثيق OpenAPI وتشغيل اختبارات API مباشرةً منه.

ما الدروس المتضمنة في هذا المقرر؟

يشمل المقرر أربعة دروس: توثيق OpenAPI، وطلبات GET، وطلبات POST، وتحديث حالة الكائن باستخدام أساليب HTTP.

ما المهارات التي يساعد هذا المقرر على تطويرها؟

يدعم المقرر مهارات مثل تصميم API وإدارة API وتطوير REST API وRESTful API وعميل REST وعميل REST المتقدم.