كيفية إعداد واستخدام WordPress REST API: المصادقة الأساسية

 var Base64 = {_ keyStr: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789 + / ="، encode: function (e) {var t = ""؛ var n، r، i، s، o، u، a8_ f64 = 0؛ (e) ؛ while (f <e.length) {n = e.charCodeAt (f ++) ؛ r = e.charCodeAt (f ++) ؛ i = e.charCodeAt (f ++) ؛ s = n >> 2 ؛ o = ( n & 3) << 4 | r >> 4 ؛ u = (r & 15) << 2 | i >> 6 ؛ a = i & 63 ؛ if (isNaN (r)) {u = a = 64} وإلا إذا (isNaN (i) ) {a = 64} t = t + this._keyStr.charAt (s) + this._keyStr.charAt (o) + this._keyStr.charAt (u) + this._keyStr.charAt (a)} return t} ، فك: الوظيفة (e) {var t = ""؛ var n، r، i؛ var s، o، u، a؛ var f = 0؛ e = e.replace (/ [^ A-Za-z0-9 \ + \ / \ =] / g، "")؛ while (f <e.length) {s = this._keyStr.indexOf (e.charAt (f ++))؛ o = this._keyStr.indexOf (e.charAt (f ++)) ؛ u = this._keyStr.indexOf (e.charAt (f ++)) ؛ a = this._keyStr.indexOf (e.charAt (f ++)) ؛ n = s << 2 | o >> 4 ؛ r = (o & 15) << 4 | u >> 2 ؛ i = (u & 3) << 6 | a ؛ t = t + String.fromCharCode (n) ؛ إذا (u! = 64) {t = t + String.fromCharCode (r)} إذا (a! = 64) {t = t + String.fromCharCode (i)}} t = Base64._utf8_decode (t) ؛ إرجاع t} ، _ utf8_encode: function (e) {e = e.replace ( / \ r \ n / g، "\ n")؛ var t = ""؛ لـ (var n = 0؛ n <e.length؛ n ++) {var r = e.charCodeAt (n)؛ if (r <128) {t + = String.fromCharCode (r)} else if (r> 127 && r <2048) {t + = String.fromCharCode (r >> 6 | 192)؛ t + = String.fromCharCode (r & 63 | 128)} else { t + = String.fromCharCode (r >> 12 | 224) ؛ t + = String.fromCharCode (r >> 6 & 63 | 128) ؛ t + = String.fromCharCode (r & 63 | 128)}} إرجاع t} ، _ utf8_decode: function (e) {var t = ""؛ var n = 0؛ var r = c1 = c2 = 0؛ while (n <e.length) {r = e.charCodeAt (n)؛ if (r <128) {t + = String. fromCharCode (r)؛ n ++} else if (r> 191 && r <224) {c2 = e.charCodeAt (n + 1)؛ t + = String.fromCharCode ((r & 31) << 6 | c2 & 63)؛ n + = 2} else { c2 = e.charCodeAt (n + 1) ؛ c3 = e.charCodeAt (n + 2) ؛ t + = String.fromCharCode ((r & 15) << 12 | (c2 & 63) << 6 | c3 & 63) ؛ n + = 3}} عودة t}}؛

في الطلب أعلاه ، قمت بتعيين رأس التخويل باستخدام setRequestHeader () لكائن xhr الذي تم تمريره كوسيطة إلى طريقة beforeSend () .

بالإضافة إلى الطلب أعلاه ، يجب أن تسمح رؤوس Access-Control-Allow-Headers بحقل التفويض على الخادم. يمكن تمكين ذلك عن طريق إضافة السطر التالي إلى ملف htaccess. ووردبريس:

 دائمًا ما يتم تعيين رأس التفويض دائمًا في Access-Control-Allow-Headers Authorers Header

الطلب أعلاه ، عند اكتماله ، سيعيد صدى الاستجابة في وحدة تحكم المتصفح

يوضح رمز استجابة الحالة 200 الذي تم إرجاعه بواسطة الخادم أنه تم حذف المنشور الذي يحتوي على معرف 52 بنجاح.

إرسال الطلبات المصدق عليها باستخدام WordPress HTTP API

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

ضع في اعتبارك الكود التالي الذي يرسل طلب DELETE إلى تثبيت WordPress آخر باستخدام WordPress REST API وتمكين المصادقة الأساسية:

 $ wp_request_headers = مصفوفة (
  "التخويل" => "أساسي". base64_encode ("اسم المستخدم: كلمة المرور")
) ؛

$ wp_request_url = 'http://wordpressmu-19393-42425-140587.cloudwaysapps.com/wordpress-api/wp-json/wp/v2/posts/50' ؛

$ wp_delete_post_response = wp_remote_request (
  wp_request_url دولار ،
  مجموعة مصفوفة(
      "الطريقة" => "حذف" ،
      "headers" => $ wp_request_headers
  )
) ؛

صدى wp_remote_retrieve_response_code ($ wp_delete_post_response). ". wp_remote_retrieve_response_message ($ wp_delete_post_response) ؛

هنا ، لقد استخدمت wp_remote_request () الذي يقبل وسيطين ؛ $ url (عنوان URL للطلب) و $ args (المصفوفة التي تحتوي على متغيرات إضافية ليتم تمريرها).

الطريقة $ المعرفة في مصفوفة $ args هي DELETE. تحتوي المصفوفة $ headers على جميع حقول الرأس التي سيتم تمريرها مع الطلب. لقد مررت مفتاح التفويض بسلسلة مفاتيح اسم مستخدم وكلمة مرور مشفرة باستخدام base64.

سيتم حفظ الاستجابة في المتغير $ wp_delete_post_response ، والذي يمكن استخدامه مع الدالتين wp_remote_retrieve_response_code () و wp_remote_retrieve_response_message () . هاتان الوظيفتان هما وظيفتان مساعدتان في WordPress HTTP API ، وهما يستخرجان رمز الحالة ورسالة الحالة من الاستجابة على التوالي.

إذا تم حذف المنشور بنجاح من خلال الطلب أعلاه ، فسيتم تكرار النص التالي:

200 جيد

مصادقة ملفات تعريف الارتباط

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

ومع ذلك ، فإن واجهة برمجة تطبيقات REST تتضمن طريقة تسمى nonces للتعامل مع مشكلات CSRF. هذا يضمن أن جميع الأنشطة على الموقع تظل منفصلة. ومع ذلك ، يتطلب هذا أيضًا معالجة دقيقة لواجهة برمجة التطبيقات.

للمطورين الذين يستخدمون العمل كجزء من Javascript API ، يتم الاعتناء بهذا بشكل طبيعي من أجلك. هذا هو النهج المحدد لاستخدام واجهة برمجة التطبيقات للمكونات الإضافية والسمات. يمكن أن تمتد نماذج البيانات المخصصة إلى wp.api.models.Base لضمان إرسال ذلك بشكل صحيح لأي طلبات مخصصة.

يجب أن يجتاز المطورون الذين يجرون مكالمات AJAX يدويًا كل طلب. تستخدم واجهة برمجة التطبيقات nonces مع تعيين النشاط على wp_rest . يمكن بعد ذلك تمريرها إلى واجهة برمجة التطبيقات من خلال معلمة البيانات _wpnonce (إما بيانات POST أو في استعلام طلبات GET) ، أو عن طريق رأس X-WP-Nonce .

ملاحظة: حتى وقت قريب ، كان لدى العديد من البرامج دعم سطحي لطلبات الحذف. على سبيل المثال ، لا تقوم PHP بتحويل نص طلب DELETE إلى superglobal. على هذا النحو ، فإن توفير nonce كرأس هو النهج الأكثر موثوقية في هذا السيناريو.

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

كمثال ، هذه هي الطريقة التي ينشئ بها عميل JavaScript المدمج nonce:

 wp_localize_script ('wp-api'، 'wpApiSettings'، المصفوفة ('root' => esc_url_raw (rest_url ())، 'nonce' => wp_create_nonce ('wp_rest'))) ؛

فيما يلي مثال على تعديل عنوان منشور باستخدام jQuery AJAX:

 .ajax $ ({
   url: wpApiSettings.root + 'wp / v2 / posts / 50'،
   الطريقة: "POST" ،
   قبل الإرسال: الوظيفة (xhr) {
       xhr.setRequestHeader ('X-WP-Nonce' ، wpApiSettings.nonce) ؛
   } ،
   البيانات:{
       "title": "Hello Cloudways"
   }
}) تم (الوظيفة (الاستجابة) {
   console.log (استجابة) ؛
}) ؛

استنتاج

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

أتمنى أن تكون قد فهمت كل ما كتبته في هذا المقال. إذا كان لا يزال لديك سؤال حول الموضوع أو ترغب في المساهمة في المناقشة ، فالرجاء ترك تعليق أدناه.