ما هي WordPress REST API وكيف تستخدمها؟

ربما سمعت عن REST API. ربما سمعت أن مستخدمي WordPress يستفيدون منه. ولكن قد تتساءل أيضًا عن ماهية واجهة برمجة تطبيقات WordPress بالضبط.

إن فهم كيفية عمل واجهات برمجة التطبيقات ليس معقدًا كما يبدو. استمر في القراءة لتتعرف على ماهية API ، وما هي REST API ، وكيف يمكنك استخدام WordPress REST API في مواقعك.

ما هي API؟

واجهة برمجة التطبيقات (API) هي وسيلة لتطبيقين "للتحدث" مع بعضهما البعض. يقوم أحد الأنظمة بتقديم طلب والآخر يفي به. يجب تضمين الطلبات التي يقبلها النظام في واجهة برمجة التطبيقات - وإلا لا يمكن تلبية الطلب.

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

سيترك النظام الذي يطلب الفطائر من قائمة API التي تقدم الفطائر فقط جائعًا.

ما هي واجهة برمجة تطبيقات REST؟

عندما نقول REST API ، فإننا نتحدث عن نظام من القيود مصمم للإنترنت. يصف كيف يمكن لأحد مواقع الويب أن يطلب معلومات من موقع ويب آخر بطريقة قابلة للتطوير وموحدة. REST تعني النقل التمثيلي للدولة ، والذي حدده روي فيلدينغ في أطروحة الدكتوراه الخاصة به.

ما هي WordPress REST API؟

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

هذا أساسي لـ Block Editor ، الذي يتبادل البيانات ديناميكيًا مع WordPress دون إعادة تحميل الصفحة. تعرض كل نقطة نهاية بيانات بتنسيق JSON يمكن قراءته بواسطة JavaScript - أو في هذه الحالة كتل.

لاحظ أن واجهة برمجة تطبيقات REST هي واحدة فقط من واجهات برمجة التطبيقات التي يوفرها WordPress. هناك أيضًا ، على سبيل المثال ، واجهة برمجة تطبيقات قاعدة البيانات وواجهة برمجة تطبيقات البيانات الوصفية ، والتي يتم استخدامها بواسطة المكونات الإضافية للتفاعل مع WordPress على الخادم. يمكنك معرفة المزيد عن WordPress APIs في Codex.

كيف يعمل طلب WordPress REST API؟

هناك بعض الأجزاء الأساسية لواجهة برمجة تطبيقات REST ، وهي: المسارات ونقاط النهاية والطلبات والاستجابات.

طرق

الطريق هو كيف نشير إلى عنوان URL الذي يتواصل من خلاله موقع الويب. الطريق الشائع في WordPress هو "/ wp-admin". على الرغم من أنه ليس مسارًا لواجهة برمجة تطبيقات REST ، إلا أنه مسار يستخدمه المتصفح للوصول إلى لوحة تحكم مسؤول WordPress. لأغراضنا ، تبدأ مسارات REST API بـ "/ wp-json" (مع كون JSON هو التنسيق القياسي للبيانات).

نقاط النهاية

نقطة النهاية هي مزيج من المسار ونوع الطلب الوارد. يمكن أن يتصل مسار واحد بنقاط نهاية متعددة ، حيث توجد أنواع طلبات متعددة. تشمل أنواع الطلبات الشائعة GET (كيف نقرأ البيانات على الطريق) و POST (كيف نقوم بتحديث البيانات على الطريق).

الطلبات والردود

يقع كل اتصال مع واجهة برمجة تطبيقات REST بين الطلب والاستجابة. يقوم أحد الأنظمة بتقديم طلب يستجيب له النظام الآخر. تتضمن واجهة برمجة تطبيقات WordPress REST كائنات مفيدة للمكونات الإضافية للوصول إلى بيانات الطلب (WP_REST_Request) وإدارة بيانات الاستجابة (WP_REST_Response) عند توسيع واجهة برمجة تطبيقات WordPress REST.

كيفية تثبيت REST API في WordPress

اعتبارًا من الإصدار 4.7 من WordPress ، يتضمن WordPress واجهة برمجة تطبيقات REST كميزة أساسية.

إذا كنت تقوم بتشغيل إصدار أقدم ، فيمكنك تثبيت المكون الإضافي لميزة json-rest-api. تم استخدام هذا لتطوير واجهة برمجة تطبيقات REST قبل أن يتم دمجها بشكل كامل مع قاعدة كود WordPress. تم إغلاق هذا المكون الإضافي من الناحية الفنية ، لذا يوصى بتحديث إصدار WordPress الخاص بك بدلاً من ذلك (أو ربما فكر في استضافة WordPress المُدارة وستكون دائمًا محدثًا.)

أمثلة على WordPress REST API

قم بإلقاء نظرة على موقع ويب GiveWP. إذا انتقلت إلى مدونتهم ، فستتمكن من رؤية آخر الأخبار والمشاركات. يعرض هذا المسار HTML ، وهو أمر جيد النظر إليه ، ولكن يصعب على المبرمج التفاعل معه. بدلاً من ذلك ، يتم توفير المنشورات للمبرمجين باستخدام المسار "/ wp-json / wp / v2 / posts".

يخبرنا المسار "/ wp-json / wp / v2 / posts" أن هذا هو مورد WordPress (“/ wp”) ، وأن هذا هو الإصدار 2 (“/ v2 /”) من المورد ، وعلى وجه التحديد أن هذه هي المشاركات ("/ المشاركات"). إذا لم تكن قد قمت بذلك بالفعل ، فتفضل بزيارة https://givewp.com/wp-json/wp/v2/posts وقارن ما تراه بـ https://givewp.com/blog/. سأعطيكم تلميحًا - إنها نفس المعلومات!

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

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

يمكن لكل مكون فردي طلب البيانات التي يحتاجها (بما في ذلك التحقق من وجود تحديثات) ثم إعادة تقديم ما تغير فقط.

الآن أنت تعرف

الآن بعد أن حصلت على الغرض من واجهة برمجة تطبيقات WordPress REST وهيكلها ، تجول لترى ما يمكنك أن تجده بنفسك. للحصول على ملخص كامل حول استخدام واجهة برمجة تطبيقات WordPress REST وتوسيعها ، تحقق من دليل REST API.

تذكر: إذا سألك شخص ما عن واجهات برمجة التطبيقات ، فلا يمكنك طلب الفطائر في Waffle House.

أثناء قيامك بضبط موقعك ، لا تنس أن المواقع الرائعة تحتاج إلى استضافة رائعة. يمكنك الحصول على كل ذلك مع Managed WordPress بواسطة Nexcess. بفضل السرعات القوية وخيارات قابلية التوسع والدعم المتميز ، يمكنك الاعتماد على Nexcess لتشغيل موقع WordPress الخاص بك.

تعال وانظر لماذا تم دمج الأفضل مع Nexcess. تحقق من خطط الاستضافة المُدارة بالكامل على WordPress اليوم.

موارد ووردبريس ذات الصلة

• WordPress.com مقابل WordPress.org
• 5 تقنيات متقدمة لتسريع موقع WordPress الخاص بك
• ما هي استضافة WordPress؟
• الدليل الأساسي لملحقات WordPress
• كيفية اختيار مضيف الويب: ما الذي تبحث عنه وما الذي يجب تجنبه