🛍️ عروض عمان

تخطى إلى المحتوى

📘 وثائق واجهة برمجة التطبيقات (API)

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

🌐 العنوان الأساسي (Base URL)

https://oman-offers.com/wp-json

🔑 نقاط النهاية الرئيسية (Key Endpoints)

1. جلب جميع المقالات (العروض)

  • الرابط: /wp/v2/posts
  • الطريقة: GET
  • الوصف: يجلب قائمة بجميع المقالات والعروض المنشورة.
  • مثال على الطلب:
curl https://oman-offers.com/wp-json/wp/v2/posts

2. جلب صفحة معينة

  • الرابط: /wp/v2/pages/{id}
  • الطريقة: GET
  • الوصف: يجلب محتوى صفحة محددة باستخدام معرفها (ID).
  • مثال على الطلب (لصفحة الأسئلة الشائعة):
curl https://oman-offers.com/wp-json/wp/v2/pages/323701

3. جلب تصنيفات معينة

  • الرابط: /wp/v2/categories
  • الطريقة: GET
  • الوصف: يجلب قائمة بجميع التصنيفات المستخدمة في الموقع.
  • مثال على الطلب:
curl https://oman-offers.com/wp-json/wp/v2/categories

🔍 البحث عن العروض

  • الرابط: /wp/v2/posts?search={كلمة_البحث}
  • الطريقة: GET
  • الوصف: يبحث في المقالات والعروض عن كلمة معينة.
  • مثال: للبحث عن عروض “لولو”:
curl "https://oman-offers.com/wp-json/wp/v2/posts?search=لولو"

📂 التصفية حسب التصنيف

  • الرابط: /wp/v2/posts?categories={id}
  • الطريقة: GET
  • الوصف: يجلب العروض التي تنتمي إلى تصنيف معين.
  • مثال: للحصول على عروض تصنيف “لولو هايبرماركت”:
curl "https://oman-offers.com/wp-json/wp/v2/posts?categories=69"

ملاحظة: يمكنك الحصول على معرف التصنيف (ID) من خلال استدعاء /wp/v2/categories.

📌 ملاحظات مهمة

  • البيانات المرتجعة: تكون بصيغة JSON.
  • عدد النتائج: الافتراضي هو 10 نتائج لكل صفحة. يمكنك التحكم بالعدد عبر المعامل per_page (مثل: ?per_page=20).
  • الترقيم: استخدم page للتنقل بين الصفحات (مثل: ?page=2).

📱 التواصل والدعم

لأي استفسار أو مساعدة، يمكنك التواصل معنا عبر:

آخر تحديث: 2026-08-01