واجهات برمجة تطبيقات WordPress: ما هي وكيفية استخدامها

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

على الرغم من أن الأمر قد يبدو معقدًا، إلا أن فهم المصطلحات الأساسية مثل JSON وREST وAPI يمكن أن يبسط كيفية تفاعلك مع إمكانيات WordPress واسعة النطاق.

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

API تعني "واجهة برمجة التطبيقات"، وهي في الأساس مجموعة من تعليمات ومعايير البرمجة التي تسمح لتطبيقات البرامج المختلفة بالتواصل مع بعضها البعض.

تخيل أن أحد التطبيقات البرمجية يعطي توجيهات إلى تطبيق آخر، فواجهة برمجة التطبيقات (API) هي مجموعة القواعد المتفق عليها التي تحكم هذا التفاعل. عندما يرسل أحد البرامج تعليمات إلى برنامج آخر، فإن واجهة برمجة التطبيقات (API) تسهل الإجراء أو توفر المعلومات الضرورية.

يمكنك التفكير في واجهة برمجة التطبيقات (API) باعتبارها "واجهة المستخدم" بين نظامين برمجيين، تتعامل مع نقل البيانات وتنفيذ المهام، ولكنها غير مرئية للمستخدم النهائي.

أمثلة على واجهات برمجة التطبيقات

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

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

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

بمجرد التحقق من كل شيء، يرسل التطبيق البعيد ردًا إلى موقع التذاكر على الويب يفيد بأنه لا بأس بالمتابعة، وعند هذه النقطة تكون قد اشتريت التذاكر بنجاح. عندما يحدث كل هذا، لا ترى سوى واجهة واحدة، وهي موقع التذاكر. إنها عملية سلسة؛ خلف الكواليس، تعمل العديد من التطبيقات معًا باستخدام واجهات برمجة التطبيقات (APIs)، لكنك كمستخدم لا تلاحظ متى يتم تسليم المهام من تطبيق إلى آخر.

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

تعد عمليات شراء التذاكر وأمازون أمثلة رائعة على كيفية عمل واجهات برمجة التطبيقات (APIs) معًا، ولكن كيف ينطبق ذلك على WordPress؟

حسنا، كل الأفكار نفسها تنطبق. باستخدام WordPress API، يمكنك دفع البيانات وسحبها من وإلى WordPress.

تعد واجهة برمجة التطبيقات (API) أداة رئيسية يمكن للمطورين استخدامها لمشاركة البيانات بسهولة من موقع WordPress الخاص بهم إلى مواقع الويب أو التطبيقات الأخرى. على وجه التحديد، تتيح لك واجهة برمجة التطبيقات هذه تنفيذ إجراءات create read update delete (CRUD) على محتوى WordPress. بعض الأمثلة على أنواع المحتوى هي:

• دعامات
• أنواع المنشورات المخصصة
• الصفحات
• التصنيفات
• المستخدمين
• وسائط

ماذا يعني الراحة؟

لا يوجد قيلولة أو شخير هنا - يشير REST إلى النمط المعماري لواجهة برمجة التطبيقات (API). REST تعني نقل الحالة التمثيلية.

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

لقد خدشنا للتو سطح REST؛ إذا كنت ترغب في معرفة المزيد، راجع هذا البرنامج التعليمي المفيد REST.

تنسيق جيسون

للوصول إلى البيانات، نحتاج إلى مصدر نسحب منه. هذا هو المكان الذي يأتي فيه JSON. JSON يرمز إلى JavaScript Object Notation.

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

إليك فكرة أساسية عن الشكل الذي يبدو عليه تنسيق JSON:

[جافا سكريبت]
{"موظفين":[
{"الاسم الأول":"جين"، "الاسم الأخير":"سميث"}،
{"الاسم الأول":"آنا"، "الاسم الأخير":"أولسن"}،
{"الاسم الأول":"جوش"، "الاسم الأخير":"جونز"}
]}

[/جافا سكريبت]

تنسيق JSON في ووردبريس

لا يقوم JSON بكتابة نفسه فحسب، ولكن لا تقلق، فلا يتعين عليك إنشاء ملف JSON يدويًا. هناك مكونات إضافية يمكنها إنشائها لك. باستخدام إحدى هذه الأدوات، ستكون بيانات الموقع بالتنسيق الصحيح، بما في ذلك المستخدمين والمشاركات والصفحات والتصنيفات والمزيد.

باستخدام واجهة برمجة تطبيقات JSON REST

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

يعد استرداد البيانات أو تحديثها أمرًا بسيطًا مثل إرسال طلب HTTP. HTTP هو بروتوكول طلب/استجابة. أولاً، تقوم بإرسال طلب للحصول على البيانات ثم يتم إرسال البيانات مرة أخرى كرد.

الحصول على الطريقة

يتم استخدام طريقة GET لاسترداد المعلومات وليس لها أي تأثير على البيانات. ما عليك سوى إرسال طلب GET إلى /wp-json/wp/v2/posts . هل تريد البحث عن شيء ما؟ على سبيل المثال، إذا كنت تبحث عن "development" فستحصل على النتائج من خلال طلب GET /wp-json/wp/v2/posts?search=development .

طلب ما بعد

يتم استخدام طلب POST لإرسال البيانات. ومن خلال إمكانيات واجهة برمجة التطبيقات الجديدة، على سبيل المثال، يمكنك تحديث المستخدم. لنفترض أنك تريد تحديث المستخدم بالمعرف 10. كل ما عليك فعله هو إرسال طلب POST إلى /wp-json/wp/v2/users/10 .

لتجربة ذلك، نوصي باستخدام Postman، وهو ملحق Google Chrome.

المزيد من جافا سكريبت في هذا المزيج

Backbone.js وواجهات برمجة التطبيقات

يعد Backbone.js طريقة رائعة للعمل مع واجهة برمجة التطبيقات (API) لأنه إطار عمل مصمم للعمل مع واجهات برمجة تطبيقات REST. تشتمل واجهة برمجة تطبيقات WordPress على واجهة برمجة تطبيقات Javascript سهلة الاستخدام تعتمد على نماذج العمود الفقري. يسمح هذا لمطوري المكونات الإضافية والموضوعات بالبدء والتشغيل دون بذل جهد ومعرفة متعمقة للغاية حول تفاصيل الاتصال.

هناك الكثير من ذلك، ولكن Backbone يعطي بنية لتطبيقات الويب من خلال توفير النماذج والمجموعات وطرق العرض، ويربطها جميعًا بـ WordPress API عبر واجهة REST JSON.

ماذا يعني هذا لمطوري ووردبريس؟

مع توفر WordPress API، زادت الطرق الجديدة لاستخدامها وستستمر في ذلك مع اكتسابها شعبية. يمكن لـ WordPress API تحسين أي وظيفة موجودة في WordPress تعتمد على Javascript. فيما يلي بعض الأمثلة:

• التحقق من صحة النموذج / التقديم
• موضوعات Backbone.js أو المكونات الإضافية
• التمرير اللانهائي

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

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