دليل المطور الشامل لـ WordPress API

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

💡

هل تريد أداة رائعة لاختبار واجهة برمجة التطبيقات (API) تولد وثائق API جميلة؟

هل تريد منصة متكاملة وشاملة لفريق المطورين لديك للعمل معًا بـ أقصى إنتاجية؟

يلبي Apidog جميع متطلباتك، و يحل محل Postman بسعر أكثر اقتصادية بكثير!

button

البدء باستخدام واجهة برمجة تطبيقات ووردبريس (WordPress API)

أ) إعداد الحساب أو الموقع

إذا كنت تستخدم موقع ووردبريس ذاتي الاستضافة (WordPress.org)، فتأكد من تثبيت موقعك وتشغيله.

تسجيل الدخول/إنشاء حساب على wordpress.org

إذا كنت تعمل مع موقع WordPress.com، قم بتسجيل الدخول إلى WordPress.com وحدد لوحة تحكم موقعك.

تسجيل الدخول/إنشاء حساب على wordpress.com

تأكد من تمكين الوصول إلى واجهة برمجة تطبيقات REST — افتراضيًا، تعرض تثبيتات ووردبريس الحديثة واجهة برمجة تطبيقات WP REST على your-site-url/wp-json/.

لا يلزم إنشاء حساب إضافي بخلاف الوصول إلى الموقع (والأذونات المناسبة) — واجهة برمجة تطبيقات REST مدمجة في جوهر ووردبريس ويمكن الوصول إليها افتراضيًا.

ب) فهم بنية URL الأساسي

بالنسبة لموقع ووردبريس ذاتي الاستضافة، يكون عنوان URL الأساسي لواجهة برمجة التطبيقات هو:

https://your-site.com/wp-json/

على سبيل المثال، لاسترداد المنشورات، ستستهدف:

https://your-site.com/wp-json/wp/v2/posts

إذا كانت الروابط الثابتة الجميلة (pretty permalinks) معطلة، فلا يزال بإمكان ووردبريس تقديم واجهة برمجة التطبيقات عبر احتياطي معلمة الاستعلام — ولكن في معظم الإعدادات الحديثة، يعمل /wp-json/ مباشرة.

بالنسبة للمواقع المستضافة على WordPress.com (أو المواقع التي تستخدم واجهة برمجة تطبيقات WordPress.com REST)، قد تختلف بنية URL قليلاً، اعتمادًا على مساحة الاسم ومعرف الموقع. على سبيل المثال:

https://public-api.wordpress.com/{namespace}/{version}/sites/{site_id}/...

يرجى الاطلاع على الوثائق الرسمية في مصادر مطوري ووردبريس، للحصول على دليل أكثر تفصيلاً حول بنية URL الأساسي.

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

تدعم واجهة برمجة تطبيقات ووردبريس جميع عمليات CRUD القياسية — إنشاء، قراءة، تحديث، حذف — باستخدام طريقة HTTP المناسبة (POST, GET, PUT, DELETE). دعنا نقوم بتقسيمها مع أمثلة ملموسة يمكنك اختبارها في المتصفح أو باستخدام Apidog.

1. القراءة: استرداد المنشورات أو الصفحات

للحصول على قائمة بالمنشورات:

GET https://your-site.com/wp-json/wp/v2/posts

لجلب منشور واحد حسب المعرف (ID):

GET https://your-site.com/wp-json/wp/v2/posts/{id}

يمكنك إضافة معلمات استعلام لتصفية أو تقسيم النتائج — على سبيل المثال:

GET https://your-site.com/wp-json/wp/v2/posts?per_page=5&page=2

GET https://your-site.com/wp-json/wp/v2/posts?status=draft

يمكنك أيضًا التحكم في الحقول التي يتم إرجاعها باستخدام معلمة الاستعلام _fields (على سبيل المثال، ? _fields=id,title,excerpt,link) لتقليل حجم الحمولة وتحسين الأداء.

ينطبق الشيء نفسه على الصفحات (عبر /wp-json/wp/v2/pages) أو أنواع الموارد الأخرى مثل الوسائط والتعليقات وما إلى ذلك، اعتمادًا على ما يعرضه موقعك.

2. الإنشاء: إضافة منشور جديد

إذا كنت مصادقًا (كمسؤول أو مستخدم لديه أذونات)، يمكنك إنشاء منشور جديد عبر:

POST https://your-site.com/wp-json/wp/v2/posts

مع نص JSON، على سبيل المثال:

{
  "title": "منشوري الجديد بواسطة واجهة برمجة التطبيقات",
  "content": "تم إنشاء هذا المنشور عبر واجهة برمجة تطبيقات ووردبريس.",
  "status": "publish"
}

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

3. التحديث: تعديل منشور موجود

لتحديث منشور حسب المعرف (على سبيل المثال، تحديث عنوانه أو محتواه):

PUT https://your-site.com/wp-json/wp/v2/posts/{id}

مثال على النص (Body):

{
  "title": "عنوان محدث عبر واجهة برمجة التطبيقات",
  "content": "محتوى محدث من واجهة برمجة التطبيقات."
}

بدلاً من ذلك، تقبل بعض التطبيقات PATCH. بعد طلب ناجح، تستجيب واجهة برمجة التطبيقات بكائن المنشور المحدث.

4. الحذف: إزالة منشور

لحذف منشور حسب المعرف (ID):

DELETE https://your-site.com/wp-json/wp/v2/posts/{id}

بشكل افتراضي، هذا عادةً ما ينقل المنشور إلى سلة المهملات (إذا كانت سلة المهملات ممكّنة). يمكنك إضافة معلمات (اعتمادًا على تكوين الموقع) للحذف الدائم، إذا كان مدعومًا.

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

يمكن غالبًا جلب البيانات العامة (مثل المنشورات المنشورة) دون مصادقة.
لإنشاء محتوى أو تحديثه أو حذفه، تحتاج عادةً إلى مصادقة — عبر ملفات تعريف الارتباط لتسجيل الدخول إلى ووردبريس، أو كلمات مرور التطبيق (المتاحة منذ WP 5.6)، أو أنظمة تعتمد على OAuth / الرمز المميز.
استخدم HTTPS دائمًا في الإنتاج لحماية بيانات الاعتماد والبيانات أثناء النقل.

اختبار نقاط نهاية واجهة برمجة تطبيقات ووردبريس (المتصفح أو Apidog)

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

باستخدام المتصفح:

الصق عنوان URL (مثل .../wp-json/wp/v2/posts) في شريط عنوان المتصفح.
سيعرض المتصفح JSON الخام — لجعله قابلاً للقراءة، قم بتثبيت إضافة لتنسيق JSON (مثل JSON Formatter لـ Chrome، Firefox).

استخدام المتصفح لاختبار نقاط نهاية واجهة برمجة تطبيقات ووردبريس

باستخدام Apidog:

أنشئ نقطة نهاية API جديدة في Apidog.
أدخل عنوان URL (مثل /wp-json/wp/v2/posts).
اختر طريقة HTTP (GET, POST, PUT, DELETE).
أضف رؤوسًا (headers) إذا لزم الأمر (للمصادقة).

أرسل الطلب وافحص استجابة JSON — يعرض Apidog JSON منظمًا، والأخطاء، ورؤوس الاستجابة، ويجعل تصحيح الأخطاء أسهل من مخرجات المتصفح الخام.

اختبار نقاط نهاية واجهة برمجة تطبيقات ووردبريس باستخدام Apidog

هذه الطريقة مفيدة بشكل خاص لطلبات POST/PUT/DELETE — حيث يفتقر المتصفح وحده إلى طريقة سهلة لإرسال نصوص طلب JSON أو رؤوس مخصصة.

أفضل الممارسات والنصائح للمطورين الذين يستخدمون واجهة برمجة تطبيقات ووردبريس

استخدم _fields أو معلمات تقسيم الصفحات للحد من حجم الحمولة عند استرداد الكثير من البيانات.
صادق بأمان باستخدام كلمات مرور التطبيق أو OAuth لعمليات الكتابة.
تحقق من إعدادات الروابط الثابتة للموقع — تأكد من أن الروابط الثابتة الجميلة أو مسارات REST الاحتياطية تعمل (wp-json/).
تعامل مع الأذونات — يمكن للمستخدمين ذوي الأدوار المناسبة فقط إنشاء المحتوى أو حذفه.
تحديد المعدل ومعالجة الأخطاء — تعامل مع حالات فشل API بلطف واحترم موارد الخادم.
استخدم أدوات تنسيق JSON عند الاختبار في المتصفح لتحسين قابلية القراءة أو تصحيح الأخطاء.

الأسئلة المتكررة (FAQ)

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

س2. ما الفرق بين wp-json/wp/v2/ ونقاط نهاية public-api.wordpress.com؟
يستخدم wp-json/wp/v2/ بواسطة مواقع ووردبريس ذاتية الاستضافة (WordPress.org). تستخدم بنية public-api.wordpress.com/... بواسطة المواقع المستضافة على WordPress.com — يختلف عنوان URL الأساسي ومساحات الأسماء، لكن مفهوم واجهة برمجة تطبيقات REST يظل متشابهًا. (شاهد المزيد من الأمثلة في نظام محتوى Noroff FEU)

س3. هل يمكنني إنشاء نقاط نهاية مخصصة أو عرض أنواع منشورات مخصصة في واجهة برمجة التطبيقات؟
نعم. افتراضيًا، يتم عرض أنواع المنشورات الأساسية (المنشورات، الصفحات، الوسائط، التعليقات، إلخ). بالنسبة لأنواع المنشورات المخصصة أو الحقول المخصصة (البيانات الوصفية)، قد تحتاج إلى تسجيل دعم REST في القالب الخاص بك أو الإضافة (على سبيل المثال، باستخدام register_post_type(..., 'show_in_rest' => true)).

س4. كيف يمكنني اختبار نقاط نهاية API دون كتابة التعليمات البرمجية؟
يمكنك استخدام متصفح (لطلبات GET) — فقط انتقل إلى عنوان URL لنقطة النهاية. لطلبات POST/PUT/DELETE (أو العمليات التي تتطلب المصادقة)، استخدم أداة عميل API مثل Apidog. تسمح لك بإرسال نصوص JSON، وتعيين الرؤوس، وفحص الاستجابات بسهولة.

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

الخلاصة

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

من خلال فهم بنية URL، ونقاط النهاية الأساسية، ودلالات CRUD، والمصادقة، ومنهجية الاختبار (عبر المتصفح أو Apidog)، يمكنك دمج ووردبريس مع أي نظام خارجي تقريبًا. مع ممارسات API الجيدة — المصادقة الآمنة، والاستعلامات الفعالة، والمعالجة الصحيحة — يصبح ووردبريس أكثر من مجرد منصة تدوين — بل يصبح واجهة خلفية للمحتوى كاملة الميزات.

💡

button