OpenByt - مصدرك النهائي لمعرفة ووردبريس مجانًا

إتقان واجهة برمجة تطبيقات ووردبريس REST API: المصادقة والتكامل

أوبن بايت

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

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

Let’s break down the components of a REST API:

كيف تعمل واجهة برمجة تطبيقات REST API؟

REST API allows clients (like your browser or an app) to send requests to servers and receive data in return. Let’s break down how it works step by step:

  1. طلب العميل: يرسل العميل (التطبيق الخاص بك) طلب HTTP إلى عنوان URL محدد على الخادم. يمثل عنوان URL هذا مورداً (على سبيل المثال، مستخدم، منتج، إلخ).
    • مثال: الحصول على https://api.example.com/users يطلب قائمة المستخدمين.
  2. معالجة الخادم: يستقبل الخادم الطلب، ويعالجه، ويسترجع البيانات (عادةً من قاعدة بيانات)، ويجهز الاستجابة.
  3. استجابة الخادم: يرسل الخادم استجابة HTTP إلى العميل. تتضمن هذه الاستجابة:
    • رمز الحالة: To indicate if the request was successful (e.g., 200 OK for success, 404 Not Found if the resource doesn’t exist).
    • البيانات: عادةً بصيغة JSON، تمثل المورد المطلوب.

المصادقة الأساسية: ما هو ولماذا هو مهم؟

المصادقة الأساسية طريقة بسيطة للمستخدمين للتحقق من هويتهم عند طلب واجهة برمجة التطبيقات. في هذه الطريقة، يرسل العميل اسم المستخدم وكلمة المرور المشفّرين في رأس الطلب، ثم يقوم الخادم بالتحقق من صحة ذلك.

لماذا هو مهم؟: تضمن المصادقة وصول المستخدمين المصرح لهم فقط إلى الموارد، مما يمنع المستخدمين غير المصرح لهم من الوصول إلى الموارد.

كيف تعمل؟: عندما يرسل العميل طلباً إلى الخادم، فإنه يتضمن التفويض مع ترميز بيانات الاعتماد في Base64.

مثال:： مثال

التخويل: أساسي dXNlcm5hbWU6cGFzc3dvcmQ=

يقوم الخادم بفك تشفير هذا الرأس ويتحقق مما إذا كان اسم المستخدم وكلمة المرور صالحين.

طرق المصادقة لواجهة برمجة تطبيقات ووردبريس REST API

عند العمل مع واجهة برمجة تطبيقات ووردبريس REST API، يمكن استخدام العديد من طرق المصادقة لتأمين الطلبات:

1 ： المصادقة الأساسية

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

3 ：مصادقة المصادقة

4 ：كلمات مرور التطبيقات

تعظيم التطوير باستخدام واجهة برمجة تطبيقات ووردبريس REST API

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

1 ： نقاط النهاية المخصصة: يمكنك إنشاء نقاط نهاية مخصصة لعرض بيانات إضافية من موقع ووردبريس الخاص بك والتي قد لا تكون متاحة بشكل افتراضي.

مثال على ذلك:

إضافة_إجراء('rest_api_init'، دالة() {
  register_rest_route('myplugin/v1', '/custom-data/', array(
    'الطرق' => 'GET',
    'callback' => 'my_custom_data_callback',
  ));
});

الدالة my_custom_data_callback() {) {
  إرجاع استجابة WP_REST_REST_Response (صفيف('data' => 'مرحبًا أيها العالم!')، 200);
}

2ـ تكامل جافا سكريبت: استخدم JavaScript لإرسال الطلبات إلى واجهة برمجة تطبيقات REST لإنشاء تجارب مستخدم ديناميكية وتفاعلية. على سبيل المثال، يمكنك إنشاء تطبيق React أو Vue.js يتفاعل مع الواجهة الخلفية لوردبريس عبر واجهة برمجة تطبيقات REST.

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

إرسال طلبات مصادق عليها باستخدام جافا سكريبت

لإرسال طلبات مصادق عليها باستخدام JavaScript، يجب عليك تضمين بيانات الاعتماد أو الرموز المميزة الصحيحة في رؤوس الطلبات. على سبيل المثال:

جلب('https://api.example.com/users'، {
  الطريقة: 'GET',
  الرؤوس: {
    'ترخيص': 'أساسي' + btoa('اسم المستخدم: كلمة المرور'),
    'نوع المحتوى': 'تطبيق/جوسون'
  }
})
  .then(response => response.json()))
  .then(data => console.log(data)));

في هذا المثال، تقوم الدالة btoa() بترميز بيانات الاعتماد في Base64 للمصادقة الأساسية.

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

When working with cookie authentication, you can use the WordPress logged-in user’s session cookies to access the REST API. Here’s a step-by-step example of how it works:

  1. تسجيل دخول المستخدم The user logs in to your WordPress site, and WordPress sets an authentication cookie in the user’s browser.
  2. إرسال الطلبات: عندما تطلب شيفرة JavaScript الخاصة بك واجهة برمجة تطبيقات REST API، يقوم المتصفح بتضمين ملف تعريف الارتباط في رؤوس الطلبات، ويعرف WordPress المستخدم الذي يقوم بالطلب.

إرسال الطلبات باستخدام واجهة برمجة تطبيقات ووردبريس HTTP

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

مثال على إرسال طلب GET:

$response = wp_remote_get('https://api.example.com/users');
إذا كان (is_wp_ror($response)) {
  $error_message = $response->get_error_message();
  إيكو "حدث خطأ ما: $error_message()";
} آخر {
  $body = wp_remote_retrieve_body($response);
  صدى $body;
}

يستخدم هذا المثال الدالة wp_remote_get() لإرسال طلب GET إلى واجهة برمجة تطبيقات خارجية واسترداد الاستجابة.

الملخص

في هذا الدليل، قمنا بتغطية:

الأسئلة الشائعة: أسئلة شائعة حول واجهة برمجة تطبيقات REST API والمصادقة

  1. هل يمكنني استخدام REST API بدون مصادقة؟
    • نعم، ولكن للبيانات العامة فقط. لأي بيانات حساسة، تحتاج إلى مصادقة مناسبة.
  2. هل المصادقة الأساسية آمنة؟
    • المصادقة الأساسية ليست آمنة للإنتاج لأن بيانات الاعتماد مشفرة وليست مشفرة. إنها مناسبة بشكل أفضل للاختبار أو عبر HTTPS.
  3. ما هي كلمات مرور التطبيق المستخدمة؟
    • تصادق كلمات مرور التطبيق على طلبات واجهة برمجة التطبيقات دون مشاركة كلمة مرور ووردبريس الأساسية. فهي تساعد في دمج تطبيقات الطرف الثالث.

الخطوات التالية

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

الخروج من إصدار الهاتف المحمول