مقدمة لواجهة برمجة تطبيقات WordPress REST

نشرت: 2017-01-13

أثار إصدار WordPress 4.7 الكثير من الإثارة في المجتمع ولسبب وجيه. إلى جانب العديد من التحسينات والميزات المقدمة ، كان سارق العرض الحقيقي هو إعلان التكامل الأساسي لـ REST API. كما ذكرنا في المنشورات السابقة ، فإن هذا يحول بشكل فعال WordPress من منصة التدوين إلى نظام إدارة المحتوى (CMS). لكن كيف سيحدث هذا التحول؟ وماذا ستكون الفوائد للمستخدمين؟

في هذه المقالة ، سوف نقدم لك أولاً بعض المفاهيم الأساسية ثم نوضح لك كيف يمكنك البدء في اللعب مع API وموقع الويب الخاص بك.

تمت ترقية جميع مواقع الويب الخاصة بعملائنا بالفعل إلى WordPress 4.7.1. فلنبدأ!

ما هي API؟

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

توجد واجهات برمجة تطبيقات للعديد من مستويات البرامج المختلفة ، بدءًا من نظام التشغيل وحتى الويب.

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

يشير REST إلى REpresentational State Transfer ويتيح نفس إمكانية التشغيل البيني واتصال المكونات ، ولكن على مستوى أعلى: الويب. باستخدام REST ، يمكنك الحصول على برامج متنوعة تستند إلى الويب مكتوبة بلغة Python أو Java أو PHP ، وتتواصل وتتبادل البيانات مع بعضها البعض ، حتى إذا كانت مستضافة في أنظمة مختلفة. نظرًا لأن كل نظام يعرف كيف "يتكلم" REST ، يمكنه التحدث مع كل من يفعل ذلك!

يستخدم REST بروتوكول HTTP كوسيلة نقل للاتصالات وطلبات HTTP القياسية لتنفيذ عملياته الأساسية. تسمى هذه العمليات الأفعال. الأكثر استخدامًا هي: PUT ، GET ، PATCH ، DELETE. تعمل هذه الأفعال على الأشياء التي تسميها REST Resources. يتم تنفيذها من قبل مطور البرامج ويقومون بتنفيذ جميع عمليات الكمبيوتر الأساسية الأربعة التي تعمل على التخزين بشكل فعال: الإنشاء والقراءة والتحديث والحذف ( CRUD ).

استضافة موقع الويب الخاص بك مع Pressidium

ضمان استرداد الأموال لمدة 60 يومًا

اطلع على خططنا

لتمثيل البيانات وتبادلها ، يستخدم REST مواصفات بيانات خفيفة الوزن تسمى JSON ( Javascript Object Notation ). هيكل JSON بسيط للغاية. إن بساطته وسهولة استخدامه ، مقارنة بألف صفحة مواصفات XML وآخرون ، أكسبته اعتمادًا فوريًا من قبل المطورين ، مما يجعله معيار تبادل البيانات الواقعي للويب.

كيف يقوم WordPress بتنفيذه؟

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

  • احصل على قائمة بالتعليقات الأخيرة.
  • الحصول على قائمة التعليقات الأخيرة على وظيفة.
  • احصل على تعليق واحد.
  • تحرير تعليق.
  • إنشاء تعليق على وظيفة.
  • قم بإنشاء تعليق كرد على تعليق آخر.
  • حذف تعليق.
  • احصل على الإعجابات للتعليق.
  • مثل تعليق.
  • إزالة إعجابك من التعليق.
  • احصل على حالة الإعجاب الخاصة بك للتعليق.

ألق نظرة على صفحة وثائق API الرسمية لـ WordPress بسهولة ، لتتعرف على اتساع API وعمقها وتحقق مما يمكنها فعله. الاحتمالات كثيرة جدا!

وبالتالي ، يصبح WordPress منصة تطوير ونظام إدارة محتوى من خلال معالجة كل جزء من البيانات الموجودة عليه كمورد REST . إنه يفضحهم جميعًا بموجب واجهة برمجة تطبيقات عامة وموحدة تسمح للأطراف الخارجية بأداء عمليات CRUD عليهم . بهذه الطريقة ، يفتح WordPress ويصبح قابلاً للتشغيل المتبادل مع بقية عالم البرامج ، سواء كان ذلك في Java أو Python أو Ruby ؛ وإلى حد كبير مع كل لغة أو نظام يعرف كيفية التواصل باستخدام REST.

جربه بنفسك

هناك عدة طرق يمكنك من خلالها البدء في تعديل واجهة برمجة تطبيقات REST الخاصة بموقعك. أسهل طريقة لاستخدام البرنامج المساعد لاختبار REST على متصفحك. هناك العديد منها ولكن الأكثر شيوعًا هو Postman (متاح لأنظمة MacOSX و Windows و Chrome).

على سبيل المثال ، لنفترض أنك تريد استرداد كائن JSON يحتوي على جميع منشورات مدونتنا. للقيام بذلك ، تحتاج أولاً إلى الرجوع إلى مرجع WordPress REST الرسمي ، من أجل معرفة المسار الأساسي لمكالمة الطلب هذه (إنه / wp / v2 / posts ).

  كل ما علينا فعله الآن هو ما يلي:

  1. حدد GET من القائمة المنسدلة. هناك العديد من أفعال REST المتاحة كما ترى ولكن تغطية كل هذه الأفعال ليس نطاق هذه المقالة.
  2. قم بإلحاق المسار الأساسي ( / wp / v2 / posts ) بعنوان REST الجذر لموقع الويب الخاص بك (http://www.acme_shop_2.onpressidium.com / wp-json / ) مكونًا عنوان URL الذي تراه على الشاشة.
  3. انقر فوق الزر إرسال .

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

مستقبل ووردبريس مشرق!

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