انتقل إلى المحتوى
لا توجد نتائج
شعار Modern Events Calendar
  • التركيب
    • التركيب
    • تفعيل
    • تحديث MEC Pro من ووردبريس
    • تحديث يدوي
    • تغيير نطاق الترخيص
  • الإعدادات
    • General
    • صفحة الأرشيف
    • الروابط الدائمة/الروابط الدائمة
    • العملة
    • عرض الكل
  • الفعاليات
    • إعدادات الحدث الفردي
    • كيفية إضافة حدث في مكون MEC الإضافي؟
    • شريط جانبي واحد لـ MEC
    • الحقول المخصصة
    • عرض الكل
  • وحدات الحدث
    • المتحدثون
    • منظمو
    • المواقع
    • خريطة
    • عرض الكل
  • إعدادات الحجز
    • وحدة الحجز
    • عناصر الحجز
    • استمارة الحجز
    • بوابات الدفع
    • عرض الكل
  • تقديم الحدث
    • General
    • مستوى الوصول
    • أقسام FES
    • الحقول المطلوبة
    • عرض الكل
  • التكاملات
    • Mailchimp
    • Paid Memberships Pro
    • BuddyPress
    • LearnDash
    • عرض الكل
  • الإشعارات
    • إشعار الحجز
    • تأكيد الحجز
    • تذكير بالحجز
    • إشعار المسؤول
    • عرض الكل
  • الإضافات
    • إضافة Elementor Single Builder
    • إضافة التذاكر والفواتير
    • إضافة مقعد الحدث
    • إضافة Virtual Events
    • عرض الكل
  • خدمات أخرى
    • إعدادات المظهر
    • خدمات ترجمة
    • معرفة
    • فحص الجهاز
    • المطورون
شعار Modern Events Calendar

  • التصنيفات
    • التركيب
      • التركيب
      • تفعيل
      • تحديث MEC Pro من ووردبريس
      • تحديث يدوي
      • تغيير نطاق الترخيص
    • إعدادات عامة
      • General
      • صفحات الأرشيف
      • الروابط الدائمة/الروابط الدائمة
      • العملة
      • عرض الكل
    • الفعاليات
      • إعدادات الحدث الفردي
      • شريط جانبي واحد لـ MEC
      • كيفية إضافة حدث في مكون MEC الإضافي؟
      • الحقول المخصصة
      • عرض الكل
    • وحدات الحدث
      • المتحدثون
      • منظمو
      • المواقع
      • خريطة
      • عرض الكل
    • إعدادات الحجز
      • وحدة الحجز
      • إضافة نظام الحجز
      • استمارة الحجز
      • إعدادات الدفع للمنظم
      • عرض الكل
    • تقديم الحدث
      • General
      • مستوى الوصول
      • أقسام FES
      • الحقول المطلوبة
      • عرض الكل
    • تكاملات MEC
      • Mailchimp
      • BuddyPress
      • LearnDash
      • Paid Memberships Pro
      • عرض الكل
    • الإشعارات
      • إشعار الحجز
      • تأكيد الحجز
      • تذكير بالحجز
      • إشعار المسؤول
      • عرض الكل
    • الإضافات
      • إضافة Elementor Single Builder
      • إضافة التذاكر والفواتير
      • إضافة مقعد الحدث
      • إضافة Virtual Events
      • عرض الكل
    • خدمات أخرى
      • إعدادات المظهر
      • خدمات ترجمة
      • معرفة
      • فحص الجهاز
      • المطورون

يقدم تذكرة
شعار Modern Events Calendar

تبديل
  • عنوان URL الأساسي
  • مفتاح API
  • كل الأحداث
    • أطلب
    • استجابة
  • حدث فردي
    • أطلب
    • استجابة
  • تسجيل الدخول
    • أطلب
    • استجابة
  • تحميل الصور
    • أطلب
    • استجابة
  • تحميل الملف
    • أطلب
    • استجابة
  • انشاء حدث
    • أطلب
    • استجابة
  • تحرير الحدث
    • أطلب
    • استجابة
  • بلدي الأحداث
    • أطلب
    • استجابة
  • حدث القمامة
    • أطلب
    • استجابة
  • حذف الحدث
    • أطلب
    • استجابة
  • كيانات التصنيف
    • قائمة كيانات التصنيف
      • معلمات المسار:
      • معلمات الاستعلام:
      • نموذج استجابة:
      • ملاحظة:
    • الحصول على كيان تصنيفي واحد
      • معلمات المسار:
      • نموذج الاستجابة (الفئة):
      • نموذج الرد (المتحدث):
      • نموذج الرد (من الراعي):
      • نموذج الاستجابة (التسمية):
      • نموذج الاستجابة (الوسم):
    • إنشاء كيان تصنيفي
      • معلمات المسار:
      • نص الطلب:
      • المعلمات الخاصة بالكيان:
      • نموذج الطلب (الفئة):
      • نموذج طلب (متحدث):
      • نموذج طلب (الراعي):
      • طلب عينة (ملصق):
      • طلب عينة (علامة):
      • نموذج استجابة:
    • تحديث كيان التصنيف
      • معلمات المسار:
      • نص الطلب:
      • طلب عينة:
      • نموذج استجابة:
    • حذف كيان التصنيف
      • معلمات المسار:
      • نموذج استجابة:
    • استجابات الخطأ
      • لم يتم العثور على الكيان (404):
      • غير مصرح به (401):
      • خطأ في التحقق (400):
  • الحقول المخصصة
    • أطلب
    • استجابة
  • الرموز
    • أطلب
    • استجابة
  • الطقس
    • أطلب
    • استجابة
  • أحداث ذات صلة
    • أطلب
    • استجابة
  • الأحداث التالية / السابقة
    • أطلب
    • استجابة
  • الأحداث القادمة
    • أطلب
    • استجابة
  • حقول الحضور
    • أطلب
    • استجابة
  • الحقول الثابتة
    • أطلب
    • استجابة
  • اختلافات التذاكر
    • أطلب
    • استجابة
  • ضريبة الحجز / الرسوم
    • أطلب
    • استجابة
    • أطلب
    • استجابة
  • أدلة المطورين ذات الصلة

المطور

واجهة برمجة تطبيقات MEC Restful

تتيح واجهة برمجة التطبيقات RESTful في Modern Events Calendar للمطورين الوصول إلى بيانات الأحداث واسترجاعها وإدارتها برمجيًا من تطبيقات أو مواقع ويب أو خدمات خارجية. كما توفر طريقة منظمة وموحدة للتفاعل مع بيانات MEC (مثل الأحداث والمواقع والمنظمين والجداول الزمنية) دون الحاجة إلى واجهة WordPress. وهذا يجعلها مناسبة للتكامل مع تطبيقات الجوال ومنصات الطرف الثالث أو تطبيقات الواجهة الأمامية المخصصة.

عنوان URL الأساسي

يختلف عنوان URL الأساسي لكل موقع ويب، ولكن النمط العام يكون كما يلي.

http://example.com/wp-json/mec/v1.0

مفتاح API

The RESTful API is a MEC Pro feature. Enable it with the تفعيل واجهة برمجة التطبيقات (API) الخيار في RESTful API section of MEC Settings, then click + إضافة مفتاح to create an API key. The API key is required for all the following commands. You should send the API key in headers with the name of رمز mec إذا لم ترسل mec-token في الرؤوس، فسوف تتلقى رمز واجهة برمجة التطبيقات غير صالح خطأ.

كل الأحداث

GET    /events/

هذا أمر عام، وهذا يعني أن جميع المستخدمين الذين لديهم مفتاح API يمكنهم تشغيله.

أطلب

أرسل المعلمات التالية بصيغة JSON.

الاسم النوعالقيم المقبولةمثال
قصرعدد صحيح 12
طلبسلسلةASC / DESCASC
عوضعدد صحيح 0
start_date_typeسلسلةاليوم / التاريخ / غدًا / أمس / بداية الشهر الماضي / بداية الشهر الحالي / بداية الشهر التاليتاريخ
تاريخ البدءسلسلة(yyyy-mm-dd)2024-12-15
end_date_typeسلسلةDefault: dateتاريخ
تاريخ الانتهاءسلسلة(yyyy-mm-dd)2025-12-15
keyword, categories, labels, locations, organizers, speakers, sponsors, tags, addressسلسلةFilters. Exclusion variants: ex_categories, ex_labels, ex_locations, ex_organizers, ex_speakers, ex_tags
عرض الأحداث الماضية فقطعدد صحيح0,10
تضمين الأحداث الماضيةعدد صحيح0,10
عرض الأحداث الجارية فقطعدد صحيح0,10
تضمين الأحداث الجاريةعدد صحيح0,10

استجابة

ستتلقى جميع الأحداث في مفتاح "الأحداث" ضمن الاستجابة. تُصنّف الأحداث بناءً على تاريخ بدايتها، ما يتيح لك عرضها بأي تنسيق تريده، مثل عرض القائمة، أو عرض التقويم الشهري، أو عرض الجدول الزمني الأسبوعي، أو أي تنسيق آخر.

يمكنك أيضًا استخدام مفتاح الترقيم في الاستجابة لقراءة جميع الأحداث صفحةً صفحة. ما عليك سوى إرسال قيمة next_date كـ start_date لطلبك التالي، وإرسال next_offset كقيمة لمعامل الإزاحة.

{
   "events": {
      "2025-01-15": [{ ... }],
	...
   },
   "pagination": {
       "next_date": "2025-12-15",
       "next_offset": 1,
       "has_more_events": true,
       "found": 12
   }
}

حدث فردي

GET    /events/{id}

هذا أمر عام، وهذا يعني أن جميع المستخدمين الذين لديهم مفتاح API يمكنهم تشغيله.

أطلب

أرسل المعلمات التالية كسلسلة استعلام.

الاسم النوعمثال
id *عدد صحيح1
ظهورعدد صحيح1747335600

استجابة

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

{
   "ID": 1,
   "data": { ... },
   "dates": [{
     "start": {
         "date": "2025-05-15",
         "hour": 7,
         "minutes": "0",
         "ampm": "PM",
         "timestamp": 1747335600
     },
     "end": {
         "date": "2025-05-15",
         "hour": 11,
         "minutes": "0",
         "ampm": "PM",
         "timestamp": 1747350000
     },
     "allday": "0",
     "hide_time": "0",
     "past": 0
   }],
   "date": {}
}

تسجيل الدخول

POST    /login

أطلب

إرسال المعلمات التالية كبيانات نموذجية.

الاسم النوعمثال
اسم المستخدم *سلسلةالمستخدم
كلمه السر *سلسلة12345678

استجابة

استخدم رمز لتفويض المستخدمين في أوامر أخرى. يجب إرسالها كرأس جديد باسم mec-user للأوامر التي تتطلب مصادقة مثل أوامر my-events أو trash events.

{
   "success": 1,
   "id": 1,
   "token": "W2X53XpClol8TquAIKWaZo0j68L0tuho3o4wmwD0"
}

تحميل الصور

POST    /images

Users must be authenticated for this command. Both mec-token and mec-user should be included in the headers.

أطلب

Send following parameters as multipart form data. Allowed extensions: PNG, JPG, JPEG and GIF.

الاسم النوعمثال
صورة *ملف

استجابة

استخدم معرف الصورة في أوامر أخرى مثل إنشاء الأحداث، وما إلى ذلك.

{
    "success": 1,
    "image_id": 10
}

تحميل الملف

POST    /files

Users must be authenticated for this command. Both mec-token and mec-user should be included in the headers.

أطلب

Send the following parameters as multipart form data. Allowed extensions: DOCX, JPG, JPEG, PNG, PDF and ZIP.

الاسم النوعمثال
ملف *ملف

استجابة

استخدم معرف الملف في أوامر أخرى مثل إنشاء الأحداث، وما إلى ذلك.

{
    "success": 1,
    "file_id": 10
}

انشاء حدث

POST    /events

Users must be authenticated for this command. Both mec-token and mec-user should be included in the headers.

أطلب

أرسل المعلمات التالية بصيغة JSON.

الاسم النوعمثال
الاسم *سلسلةاسم الحدث
محتوىسلسلةمحتوى الحدث
الموقع[الاسم]سلسلةمعرض فنون
الموقع[العنوان]نصمعرض الفنون، المدينة
الموقع[خط العرض]الطفو
الموقع[خط الطول]الطفو
الموقع[صورة مصغرة]مادبا10
المنظم[الاسم]سلسلة جون ديزاين
المنظم[البريد الإلكتروني] البريد الإلكتروني john.due@gmail.com
المنظم[الهاتف]الهاتف 13007772299+
المنظم[url]URL https://google.com
المنظم[صورة مصغرة]عدد 10
تاريخ البدءالتاريخ (سنة-شهر-يوم)2025-06-01
ساعة البدايةمادبا10
دقائق البدايةمادبا15
بدء_الصباح_بالدقيقةسلسلة AM
تاريخ الانتهاءالتاريخ (سنة-شهر-يوم)2025-06-01
نهاية الساعةمادبا2
دقائق النهايةمادبا45
نهاية الساعة بالدقيقةسلسلةPM

استجابة

استخدم معرف الحدث في أوامر أخرى مثل الحصول على حدث واحد، وما إلى ذلك.

{
    "success": 1,
    "message": "The event is published.",
    "event_id": 12
}

تحرير الحدث

PUT    /events/{id}

Users must be authenticated for this command. Both mec-token and mec-user should be included in the headers.

أطلب

الطلب يشبه تمامًا أمر إنشاء الحدث.

استجابة

والاستجابة أيضًا تشبه تمامًا أمر إنشاء الحدث.

بلدي الأحداث

GET    /my-events

Users must be authenticated for this command. Both mec-token and mec-user should be included in the headers.

أطلب

أرسل المعلمات التالية بصيغة JSON.

الاسم النوعمثال
قصرعدد صحيح12
المقسمعدد صحيح1

استجابة

يمكنك تكرار الأحداث لعرضها جميعًا. استخدم بيانات الترقيم للتنقل عبر صفحات الأحداث.

{
   "events": [
       {
           "id": 2645,
           "title": "Monthly",
           "url": "http://example.com/events/monthly/",
           "status": "publish"
       }
   ],
   "pagination": {
       "current_page": 2,
       "total_pages": 5
   }
}

حدث القمامة

DELETE    /events/{id}/trash

Users must be authenticated for this command. Both mec-token and mec-user should be included in the headers.

أطلب

لا شيء.

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
   "success": 1
}

حذف الحدث

DELETE    /events/{id}

Users must be authenticated for this command. Both mec-token and mec-user should be included in the headers.

سيُجبر هذا الأمر على حذف حدث. لا يهم إن كان الحدث قد حُذف أم لا.

أطلب

لا شيء.

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
   "success": 1
}

كيانات التصنيف

تتيح لك نقاط النهاية هذه إدارة كيانات تصنيف MEC بما في ذلك الفئات والعلامات والتصنيفات والمتحدثين والجهات الراعية.

يجب التحقق من هوية المستخدمين لتنفيذ هذه الأوامر. كلاهما mec-token و mec-user ينبغي تضمينها في العناوين.

قائمة كيانات التصنيف

GET    /taxonomies/{entity}

معلمات المسار:

معامل النوعالوصف
كيانسلسلةنوع الكيان. أحد الأنواع التالية: categories, tags, labels, speakers, sponsors

معلمات الاستعلام:

معامل النوعالترتيبالوصف
قصرمادبا20عدد العناصر في الصفحة
المقسممادبا1رقم الصفحة
ترتيب حسبسلسلةالاسمحقل الفرز. الخيارات: name, slug, count, term_id
طلبسلسلةASCترتيب الفرز. الخيارات: ASC, DESC
يبحثسلسلةمصطلح البحث لتصفية النتائج
إخفاء_فارغمنطقيةزائفهل ينبغي إخفاء المصطلحات الفارغة؟

نموذج استجابة:

{
    "data": {
        "categories": [
            {
                "id": 1,
                "name": "Music",
                "slug": "music",
                "description": "",
                "count": 5,
                "taxonomy": "mec_category",
                "icon": "",
                "color": "",
                "fallback_image": "",
                "parent": 0
            }
        ],
        "pagination": {
            "current_page": 1,
            "per_page": 20,
            "total": 1,
            "total_pages": 1
        }
    },
    "status": 200
}

ملاحظة:

  • في عمل categories، كل عنصر يتضمن icon, color, fallback_imageو parent الحقول.
  • في عمل labels، كل عنصر يتضمن color و style الحقول.
  • في عمل speakers، كل عنصر يتضمن type, job_title, tel, email, website, mec_index, facebook, twitter, instagram, linkedinو thumbnail الحقول.
  • في عمل sponsors، كل عنصر يتضمن link و logo الحقول.
  • في عمل tags، حقول المصطلحات الافتراضية فقط (id, name, slug, description, count, taxonomyيتم إرجاعها.
  • Speakers and sponsors must be enabled in MEC settings to be accessible. Sponsors also require MEC Pro.

الحصول على كيان تصنيفي واحد

GET    /taxonomies/{entity}/{id}

معلمات المسار:

معامل النوعالوصف
كيانسلسلةنوع الكيان. أحد الأنواع التالية: categories, tags, labels, speakers, sponsors
idمادبامصطلح الهوية

نموذج الاستجابة (الفئة):

{
    "data": {
        "category": {
            "id": 1,
            "name": "Music",
            "slug": "music",
            "description": "",
            "count": 5,
            "taxonomy": "mec_category",
            "icon": "",
            "color": "#ff0000",
            "fallback_image": "",
            "parent": 0
        }
    },
    "status": 200
}

نموذج الرد (المتحدث):

{
    "data": {
        "speaker": {
            "id": 2,
            "name": "John Doe",
            "slug": "john-doe",
            "description": "",
            "count": 3,
            "taxonomy": "mec_speaker",
            "type": "person",
            "job_title": "CEO",
            "tel": "+1234567890",
            "email": "john@example.com",
            "website": "https://example.com",
            "mec_index": "1",
            "facebook": "https://facebook.com/johndoe",
            "twitter": "https://twitter.com/johndoe",
            "instagram": "",
            "linkedin": "",
            "thumbnail": ""
        }
    },
    "status": 200
}

نموذج الرد (من الراعي):

{
    "data": {
        "sponsor": {
            "id": 3,
            "name": "Acme Inc",
            "slug": "acme-inc",
            "description": "",
            "count": 2,
            "taxonomy": "mec_sponsor",
            "link": "https://acme.com",
            "logo": "https://example.com/logo.png"
        }
    },
    "status": 200
}

نموذج الاستجابة (التسمية):

{
    "data": {
        "label": {
            "id": 5,
            "name": "Featured",
            "slug": "featured",
            "description": "",
            "count": 12,
            "taxonomy": "mec_label",
            "color": "#ff0000",
            "style": ""
        }
    },
    "status": 200
}

نموذج الاستجابة (الوسم):

{
    "data": {
        "tag": {
            "id": 7,
            "name": "Workshop",
            "slug": "workshop",
            "description": "Hands-on workshop sessions",
            "count": 8,
            "taxonomy": ""
        }
    },
    "status": 200
}

إنشاء كيان تصنيفي

POST    /taxonomies/{entity}

معلمات المسار:

معامل النوعالوصف
كيانسلسلةنوع الكيان. أحد الأنواع التالية: categories, tags, labels, speakers, sponsors

نص الطلب:

المعايير المشتركة لجميع أنواع الكيانات:

معامل النوعمطلوب: الوصف
الاسمسلسلةنعماسم الكيان
ضربة قويةسلسلةلارابط مختصر مناسب لعناوين المواقع (يتم إنشاؤه تلقائيًا في حالة حذفه)
وصفسلسلةلاوصف الكيان

المعلمات الخاصة بالكيان:

في عمل categories:

معامل النوعمطلوب: الوصف
أصلمادبالامعرّف الفئة الرئيسية
رمزسلسلةلافئة CSS لأيقونة الفئة
اللونسلسلةلارمز اللون السداسي (على سبيل المثال، #ff0000)
صورة احتياطيةسلسلةلارابط الصورة الاحتياطية

في عمل labels:

معامل النوعمطلوب: الوصف
اللونسلسلةلارمز اللون السداسي العشري للملصق
نمطسلسلةلانمط التسمية

في عمل speakers:

معامل النوعمطلوب: الوصف
نوعسلسلةلاperson or group. تقصير: person
مسمى وظيفيسلسلةلاالمسمى الوظيفي للمتحدث
الهاتفسلسلةلارقم الهاتف
البريد الإلكترونيسلسلةلاعنوان البريد الإلكتروني
موقع الكترونيسلسلةلارابط الموقع
مؤشر mecمادبالاعرض فهرس الترتيب. القيمة الافتراضية: 99
فيس بوكسلسلةلاعنوان URL لملف تعريف Facebook
أو تويتر سلسلةلارابط ملف تعريف تويتر
انستقرامسلسلةلاعنوان URL للملف الشخصي في Instagram
ينكدينسلسلةلارابط الملف الشخصي على LinkedIn
صورة مصغرةسلسلةلارابط الصورة المصغرة

في عمل sponsors:

معامل النوعمطلوب: الوصف
الصفحة سلسلةلارابط موقع الراعي
شعارسلسلةلارابط صورة شعار الراعي

نموذج الطلب (الفئة):

{
    "name": "Conference",
    "slug": "conference",
    "description": "Conference events",
    "color": "#3498db",
    "icon": "mec-fa-video"
}

نموذج طلب (متحدث):

{
    "name": "Jane Smith",
    "job_title": "Keynote Speaker",
    "email": "jane@example.com",
    "type": "person",
    "twitter": "https://twitter.com/janesmith"
}

نموذج طلب (الراعي):

{
    "name": "Tech Corp",
    "link": "https://techcorp.com",
    "logo": "https://techcorp.com/logo.png"
}

طلب عينة (ملصق):

{
    "name": "VIP",
    "color": "#9b59b6",
    "style": ""
}

طلب عينة (علامة):

{
    "name": "Technology",
    "description": "Technology-related events"
}

نموذج استجابة:

{
    "data": {
        "success": 1,
        "category": {
            "id": 10,
            "name": "Conference",
            "slug": "conference",
            "description": "Conference events",
            "count": 0,
            "taxonomy": "mec_category",
            "icon": "mec-fa-video",
            "color": "#3498db",
            "fallback_image": "",
            "parent": 0
        }
    },
    "status": 200
}

تحديث كيان التصنيف

PUT    /taxonomies/{entity}/{id}

معلمات المسار:

معامل النوعالوصف
كيانسلسلةنوع الكيان. أحد الأنواع التالية: categories, tags, labels, speakers, sponsors
idمادبامعرّف المصطلح المراد تحديثه

نص الطلب:

نفس معايير الإنشاء. قم بتضمين الحقول التي تريد تحديثها فقط.

طلب عينة:

{
    "name": "International Conference",
    "color": "#e74c3c"
}

نموذج استجابة:

{
    "data": {
        "success": 1,
        "category": {
            "id": 10,
            "name": "International Conference",
            "slug": "conference",
            "description": "Conference events",
            "count": 0,
            "taxonomy": "mec_category",
            "icon": "mec-fa-video",
            "color": "#e74c3c",
            "fallback_image": "",
            "parent": 0
        }
    },
    "status": 200
}

حذف كيان التصنيف

DELETE    /taxonomies/{entity}/{id}

معلمات المسار:

معامل النوعالوصف
كيانسلسلةنوع الكيان. أحد الأنواع التالية: categories, tags, labels, speakers, sponsors
idمادباThe term ID to delete

نموذج استجابة:

{
    "data": {
        "success": 1
    },
    "status": 200
}

استجابات الخطأ

لم يتم العثور على الكيان (404):

{
    "data": {
        "code": "404",
        "message": "Taxonomy entity not found!"
    },
    "status": 404
}

غير مصرح به (401):

{
    "data": {
        "code": "401",
        "message": "You're not authorized to manage this taxonomy!"
    },
    "status": 401
}

خطأ في التحقق (400):

{
    "data": {
        "code": "400",
        "message": "Name field is required!"
    },
    "status": 400
}

الحقول المخصصة

GET    /config/custom-fields

هذا أمر عام، وهذا يعني أن جميع المستخدمين الذين لديهم مفتاح API يمكنهم تشغيله.

أطلب

لا شيء.

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
    "success": 1,
    "fields": {
        "1": {
            "mandatory": "1",
            "type": "text",
            "label": "Your Comment"
        },
        "2": {
            "mandatory": "0",
            "type": "date",
            "label": "Preferred Date"
        },
        "3": {
            "mandatory": "0",
            "ignore": "0",
            "type": "select",
            "label": "Gender",
            "options": {
                "1": {
                    "label": "Male"
                },
                "2": {
                    "label": "Female"
                }
            }
        }
    }
}

الرموز

GET    /config/icons

هذا أمر عام، وهذا يعني أن جميع المستخدمين الذين لديهم مفتاح API يمكنهم تشغيله.

أطلب

لا شيء.

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
    "success": 1,
    "icons": [
        {
            "name": "Location Marker Icon",
            "default": "<i class=\"mec-sl-location-pin\"></i>",
            "modules": [
                "single",
                "shortcode"
            ],
            "value": "<img class=\"mec-custom-image-icon\" src=\"http://site.com/wp-content/uploads/2025/03/location.jpg\" alt=\"location-pin\">"
        }
    ]
}

الطقس

GET    /events/{id}/weather

This is a public command, it means all users with an API key can run it. The Weather module must be enabled, otherwise the command returns “Module is disabled.” with HTTP status 503.

أطلب

إرسال المعلمات التالية كسلسلة استعلام.

الاسم النوعمثال
تاريخسلسلةYYYY-MM-DD

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
    "success": 1,
    "weather": {
        "icon": "//cdn.weatherapi.com/weather/64x64/day/113.png",
        "condition": "Sunny",
        "temp_c": 13.699999999999999,
        "temp_f": 56.700000000000003,
        "wind_kph": 9,
        "wind_mph": 5.5999999999999996,
        "humidity": 58,
        "feelslike_c": 13.199999999999999,
        "feelslike_f": 55.799999999999997
    }
}

أحداث ذات صلة

GET    /events/{id}/related-events

This is a public command, it means all users with an API key can run it. The Related Events module must be enabled, otherwise the command returns “Module is disabled.” with HTTP status 503.

أطلب

لا شيء.

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
    "success": 1,
    "related_events": [
        {
            "id": 21,
            "title": "Daily Event",
            "url": "http://site.com/events/daily-event/",
            "timestamp": 1746432000,
            "date": "May 5, 2025"
        }
    ]
}

الأحداث التالية / السابقة

GET    /events/{id}/next-previous-events

هذا أمر عام، وهذا يعني أن جميع المستخدمين الذين لديهم مفتاح API يمكنهم تشغيله.

أطلب

لا شيء.

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
    "success": 1,
    "next": {
        "id": "21",
        "title": "Daily Event",
        "url": "http://rezamiri.test/events/daily-event/"
    },
    "previous": []
}

الأحداث القادمة

GET    /events/{id}/next-occurrences

هذا أمر عام، وهذا يعني أن جميع المستخدمين الذين لديهم مفتاح API يمكنهم تشغيله.

أطلب

لا شيء.

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
    "success": 1,
    "occurrences": [
        {
            "start": {
                "date": "2025-05-10",
                "hour": "8",
                "minutes": "0",
                "ampm": "AM",
                "timestamp": 1746864000
            },
            "end": {
                "date": "2025-05-10",
                "hour": 6,
                "minutes": "0",
                "ampm": "PM",
                "timestamp": 1746900000
            },
            "allday": "0",
            "hide_time": "0",
            "past": 0
        }
    ]
}

حقول الحضور

GET    /config/attendee-fields

هذا أمر عام، وهذا يعني أن جميع المستخدمين الذين لديهم مفتاح API يمكنهم تشغيله.

أطلب

لا شيء.

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
    "success": 1,
    "fields": [
        {
            "mandatory": "1",
            "type": "mec_email",
            "label": "Email"
        },
        {
            "mandatory": "1",
            "type": "name",
            "label": "Name"
        },
        {
            "mandatory": "0",
            "type": "textarea",
            "label": "Text",
            "mapping": ""
        }
    ]
}

الحقول الثابتة

GET    /config/fixed-fields

هذا أمر عام، وهذا يعني أن جميع المستخدمين الذين لديهم مفتاح API يمكنهم تشغيله.

أطلب

لا شيء.

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
    "success": 1,
    "fields": {
        "1": {
            "mandatory": "0",
            "type": "text",
            "label": "Text"
        },
        "2": {
            "mandatory": "1",
            "type": "date",
            "label": "Date"
        }
    }
}

اختلافات التذاكر

GET    /config/ticket-variations

هذا أمر عام، وهذا يعني أن جميع المستخدمين الذين لديهم مفتاح API يمكنهم تشغيله.

أطلب

لا شيء.

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
    "success": 1,
    "ticket_variations": {
        "1": {
            "title": "Pizza",
            "price": "6",
            "max": "2"
        },
        "2": {
            "title": "Juice",
            "price": "4",
            "max": "3"
        }
    }
}

ضريبة الحجز / الرسوم

GET    /events/{id}/fees

هذا أمر عام، وهذا يعني أن جميع المستخدمين الذين لديهم مفتاح API يمكنهم تشغيله.

أطلب

لا شيء.

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
    "success": 1,
    "fees": {
        "1": {
            "title": "Tax",
            "amount": "12",
            "type": "percent"
        },
        "2": {
            "title": "Deposit",
            "amount": "50",
            "type": "amount_per_booking"
        }
    }
}

GET    /events/{id}/tickets

هذا أمر عام، وهذا يعني أن جميع المستخدمين الذين لديهم مفتاح API يمكنهم تشغيله.

أطلب

الاسم النوعمثال
ظهورسلسلةس ...

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز http الصحيح.

{
    "success": 1,
    "tickets": {
        "1": {
            "name": "Ticket A",
            "ticket_start_time_hour": "08",
            "ticket_start_time_minute": "0",
            "ticket_end_time_hour": "06",
            "ticket_end_time_minute": "0",
            "description": "",
            "private_description": "",
            "price": "8.97",
            "price_label": "$8.97",
            "limit": "",
            "unlimited": "0",
            "seats": "1",
            "minimum_ticket": "1",
            "maximum_ticket": "",
            "stop_selling_value": "0",
            "stop_selling_type": "day",
            "dates": [],
            "ticket_start_time_ampm": "AM",
            "ticket_end_time_ampm": "PM",
            "category_ids": [],
            "id": 1,
            "variations": {
                "1": {
                    "title": "Pizza",
                    "price": "6",
                    "max": "2"
                },
                "2": {
                    "title": "Juice",
                    "price": "4",
                    "max": "3"
                }
            }
        }
    },
    "availability": {
        "1": 100,
        "seats_1": 1,
        "total": 100
    }
}

أدلة المطورين ذات الصلة

These guides cover other ways to extend MEC or share its data:

  • خطافات MEC
  • روابط الويب الخاصة بـ MEC
  • إضافة واجهة برمجة التطبيقات للحدث

مشاركة

مقالات ذات صلة

  • روابط الويب الخاصة بـ MEC
  • كيفية الحصول على حقل مخصص على صفحة حدث واحد
  • تجاوز صفحة الحدث الفردي
  • تجاوز جلود الرموز المختصرة
  • استيراد الأحداث عبر SQL
تسجيل الدخول إرسال
0 تعليقًا

لا تعليق.

لم يحالفك الحظ بعد؟ يمكننا مساعدتك!

إذا لم تجد ما تبحث عنه، يرجى تقديم تذكرة في نظام الدعم الخاص بنا.

يقدم تذكرة
لافتة Webnus
Modern Events Calendar

يرجى قراءة الشروط والأحكام وسياسة الخصوصية الخاصة بنا.

4.2 ممتاز

حول 11 قم بمراجعتنا على Trustpilot

جميع الحقوق محفوظة © ٢٠٢٣ لشركة Webnus.