واجهة برمجة تطبيقات MEC REST: نقاط النهاية، الطلبات والاستجابات

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

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

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

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

مفتاح API

مفتاح API مطلوب لجميع الأوامر التالية. يجب إرسال مفتاح API في ترويسة الطلب باسم mec-token. في حال عدم إرسال mec-token في الترويسة، ستتلقى خطأ invalid_api_token.

كل الأحداث

GET    /events/

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

أطلب

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

الاسم	النوع	القيم المقبولة	مثال
قصر	عدد صحيح		12
طلب	سلسلة	ASC / DESC	ASC
عوض	عدد صحيح		0
بداية	سلسلة	اليوم / التاريخ / غدًا / أمس / بداية الشهر الماضي / بداية الشهر الحالي / بداية الشهر التالي	تاريخ
تاريخ البدء	سلسلة	(yyyy-mm-dd)	2024-12-15
عرض الأحداث الماضية فقط	عدد صحيح	0,1	0
تضمين الأحداث الماضية	عدد صحيح	0,1	0
عرض الأحداث الجارية فقط	عدد صحيح	0,1	0
تضمين الأحداث الجارية	عدد صحيح	0,1	0

استجابة

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

يمكنك أيضًا استخدام مفتاح الترقيم في الاستجابة لقراءة جميع الأحداث صفحةً صفحة. ما عليك سوى إرسال قيمة 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    /images

يجب مصادقة المستخدمين لهذا الأمر. يجب تضمين كلٍّ من mec-token وuser-token في الرؤوس.

أطلب

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

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

استجابة

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

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

تحميل الملف

POST    /files

يجب مصادقة المستخدمين لهذا الأمر. يجب تضمين كلٍّ من mec-token وuser-token في الرؤوس.

أطلب

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

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

استجابة

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

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

انشاء حدث

POST    /events

يجب مصادقة المستخدمين لهذا الأمر. يجب تضمين كلٍّ من mec-token وuser-token في الرؤوس.

أطلب

أرسل المعلمات التالية بصيغة 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}

يجب مصادقة المستخدمين لهذا الأمر. يجب تضمين كلٍّ من mec-token وuser-token في الرؤوس.

أطلب

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

استجابة

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

بلدي الأحداث

GET    /my-events

يجب مصادقة المستخدمين لهذا الأمر. يجب تضمين كلٍّ من mec-token وuser-token في الرؤوس.

أطلب

أرسل المعلمات التالية بصيغة 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

يجب مصادقة المستخدمين لهذا الأمر. يجب تضمين كلٍّ من mec-token وuser-token في الرؤوس.

أطلب

لا شيء.

استجابة

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

{
   "success": 1
}

حذف الحدث

DELETE    /events/{id}

يجب مصادقة المستخدمين لهذا الأمر. يجب تضمين كلٍّ من mec-token وuser-token في الرؤوس.

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

أطلب

لا شيء.

استجابة

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

{
   "success": 1
}

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

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

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

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

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يتم إرجاعها.
يجب تفعيل إمكانية الوصول للمتحدثين والجهات الراعية في إعدادات MEC.

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

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	مادبا	معرّف المصطلح المراد تحديثه

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

{
    "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

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

أطلب

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

الاسم	النوع	مثال
تاريخ	سلسلة	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

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

أطلب

لا شيء.

استجابة

إذا كان الأمر ناجحًا، فستتلقى الاستجابة التالية، وإلا فسيتم إرجاع كائن خطأ يحتوي على رمز 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
    }
}

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

مفتاح API

كل الأحداث

أطلب

استجابة

حدث مفرد

أطلب

استجابة

تسجيل الدخول

أطلب

استجابة

تحميل الصور

أطلب

استجابة

تحميل الملف

أطلب

استجابة

انشاء حدث

أطلب

استجابة

تحرير الحدث

أطلب

استجابة

بلدي الأحداث

أطلب

استجابة

حدث القمامة

أطلب

استجابة

حذف الحدث

أطلب

استجابة

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

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

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

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

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

ملاحظة:

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

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

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

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

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

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

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

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

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

نص الطلب:

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

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

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

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

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

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

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

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

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

نص الطلب:

طلب عينة:

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

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

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

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

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

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

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

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

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

أطلب

استجابة

الرموز

أطلب

استجابة

الطقس

أطلب

استجابة

أحداث ذات صلة

أطلب

استجابة

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