التذاكر والتسويق،
مترابطان بذكاء.

API واحدة لبيع التذاكر وإدارة الدخول وتفعيل التسويق — بالوضوح الذي يتوقعه مدير التقنية لديكم.

اقرأ دليل البدء السريع ←أمثلةفتح في Postman

18ms

زمن استجابة P50

99.99%

الإتاحة في 2025

610

نقاط النهاية

الأقسام

1 مليار+

طلب/سنة

●POST /connect/token · GET /shop/v1/discovery/events

curl https://aditus.dev/Demo_API/api/connect/token \
  -u $CLIENT_ID:$CLIENT_SECRET \
  -d "grant_type=client_credentials&scope=Shop"

# → returns access_token

curl https://aditus.dev/Demo_API/api/shop/v1/discovery/events \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: de-DE"

النظام التجريبي

الحالة المباشرة

فحص مباشر في المتصفح

يشغّل نظام ADITUS التجريبي العام جميع الأمثلة التفاعلية في هذه البوابة — اكتشاف الفعاليات وسلة التسوق والدفع والتذاكر تعمل عبر واجهة Shop API حقيقية مع قاعدة بيانات مباشرة.

بمجرد تحميل هذه الصفحة في المتصفح، يتم التحقق مباشرةً من التوفر الحالي لواجهة Shop API وخدماتها الخلفية وزمن الاستجابة.

يبدأ الفحص المباشر عند تحميل الصفحة

موثوق ومتكامل لدى

مصمم لصنّاع القرار التقني

ست مزايا سيقدّرها فريق التكامل لديكم حقًا.

مصمم لمديري التقنية وفرق المنصات — مصادقة وتوطين وWebhooks وخاصية idempotency من دون حلول التفافية.

بيانات اعتماد العميل في OAuth 2.0

أنشئ bearer token قصيرة العمر بصلاحيات محددة مثل Shop أو TERP. ويمكن تدويرها بحرية من دون قطع الجلسات النشطة.

AUTH

مصمم للتوطين من الأساس

مرّر Accept-Language لتحصل على كل حقل نصي مترجمًا. وتنتقل الإعدادات المحلية تلقائيًا عبر سلة التسوق وإتمام الشراء.

i18n

Quicodes وروابط التذاكر

أنشئ payload قابلة للمسح عبر QR باستخدام علامة واحدة. وتُصنّف فئات regex المدمجة عمليات المسح مباشرةً ضمن تقاريرك.

ACCESS

Webhooks في الوقت الفعلي

30 حدثًا للتذاكر وسلال التسوق والمدفوعات والدخول. موقّعة باستخدام HMAC-SHA256، مع إعادة المحاولة وفق تراجع أُسّي.

EVENTS

خاصية idempotency افتراضيًا

تتضمن كل عملية كتابة ترويسة Idempotency-Key. وتُعيد الطلبات المكررة الاستجابة الأصلية مع معرّف السجل الأصلي.

RELIABILITY

أحداث جاهزة للتسويق

أرسل التحويلات وأحداث الدخول مباشرةً إلى GA4 أو Meta CAPI أو مستودع بياناتك عبر Webhooks.

ACTIVATION

صورة مارك لوتسوف، الرئيس التنفيذي لشركة ADITUS — **Marc Luzoff**CEO

Quickstart

انطلق في أربع خطوات، واستلم الدفع في الخامسة.

إنشاء token

استبدل بيانات اعتماد العميل بـ bearer token قصيرة العمر عبر /connect/token، ثم خزّنها مؤقتًا لنحو 50 دقيقة.

استكشاف الفعاليات

اجلب دليل الفعاليات بأسمائه المحلية ومواعيده وتشكيلات أسعاره. ويمكنك التصفية حسب التاريخ أو المكان أو slug.

إنشاء سلة تسوق

أنشئ سلة تسوق تدعم idempotency، وأضف العناصر حسب معرّف المنتج أو slug، واربط العميل واختر مزود الدفع.

التأكيد والتسليم

ثبّت سلة التسوق، ونفّذ إتمام الشراء، واستلم Quicodes وروابط التذاكر. ويُطلق Webhook مع كل عملية شراء ناجحة.

curl https://aditus.dev/Demo_API/api/connect/token \
  -u $CLIENT_ID:$CLIENT_SECRET \
  -d "grant_type=client_credentials&scope=Shop"

# → returns access_token

curl https://aditus.dev/Demo_API/api/shop/v1/discovery/events \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: de-DE"

يستدعي خادمكم الخلفي ADITUS:
Token
POST /connect/token
تُرسل بيانات اعتماد العميل ويُعاد bearer قصير الأجل. لا تغادر الأسرار خادمكم الخلفي أبدًا.
يستدعي خادمكم الخلفي ADITUS:
اكتشاف الفعاليات
GET /shop/v1/discovery/events
كتالوج مترجم للفعاليات والمواعيد وتشكيلات الأسعار.
يستدعي خادمكم الخلفي ADITUS:
سلة التسوق — قابلة للتكرار بأمان
POST /shop/v1/cart
أنشئوا سلة التسوق وأضيفوا العناصر واربطوا المشتري. إعادة المحاولة آمنة — السلة نفسها بلا عناصر مكررة.
يستدعي خادمكم الخلفي ADITUS:
إتمام الشراء
POST /shop/v1/cart/{id}/checkout
ثبّتوا سلة التسوق وأتمّوا الدفع. تتضمن الاستجابة Quicodes وروابط التذاكر اللازمة للتسليم.
تستدعي ADITUS خادمكم الخلفي (بصورة غير متزامنة):
Webhookغير متزامن
POST https://your-backend/webhook
بعد كل عملية شراء ناجحة، تستدعي ADITUS الـ endpoint الخاص بكم بصورة غير متزامنة ومستقلة عن استجابة إتمام الشراء.

التدفق الكامل من البداية إلى النهاية — أربعة استدعاءات متزامنة صادرة وWebhook واحد غير متزامن عائد.

صورة سيباستيان كلوغه، رئيس المنتجات في ADITUS — **Sebastian Kluge**Head of Products

Shop Micro Frontend

متجر التذاكر الذي تشعرون أنه جزء من موقعكم.

يستكشف زوّاركم التذاكر ويختارونها ويُتمّون الشراء من دون مغادرة موقعكم أبداً — بدمج لا يتطلب سوى بضعة أسطر من الكود. تنقل design tokens هوية علامتكم إلى كل خطوة، مع تجاوب وتوطين جاهزين من البداية. النتيجة: تجربة علامة متسقة، وثقة أكبر، وحالات تخلٍّ أقل عن الشراء — وبيع تذاكر يعمل ببساطة.

المزيد عن Micro Frontend ←

صفحة فعالية Experience Days مع متجر التذاكر المدمج، وتظهر فيها فئات التذاكر وتفاصيلها وأسعارها وخيارات الكمية

مصمم لمكدسكم التقني

تكامل مفتوح

Light DOM — بلا iframe أو Shadow DOM
React 18 و19
مستقل عن إطار العمل عبر mount(container, config)
خطافات CSS دلالية وDesign Tokens
تبديل مباشر للغة والثقافة

تشغيل آمن

نموذج موثق للجلسات والمصادقة
إنشاء رموز الجلسة من خادم إلى خادم
متطلبات واضحة لسياسة أمان المحتوى
بنية Payment Page تقلل نطاق PCI

جاهز للإنتاج

إعادة توجيه الدفع مع استئناف آمن للرحلة
Callbacks للمضيف وWebhooks من جهة الخادم
أحداث تجارة إلكترونية اختيارية في GA4
متوافق مع مضيفات SSR مثل Next.js وNuxt
حزمة مصدر أو Bundle ذاتي الاستضافة ومحدد الإصدار

صورة مارك إيبريشت، قائد فريق Integration & Consulting في ADITUS — **Marc Ehbrecht**Team Lead Integration & Consulting

مرجع API

جميع endpoints، مصنفة بوضوح.

من OAuth token إلى إعادة تشغيل Webhook — 11 قسمًا، مع توثيق كل طلب بالأمثلة والترويسات والاستجابات.

مقدمة

نقطة البداية لاستخدام ADITUS API: تعرّف على ما تغطيه المنصة، وكيف تترابط الأقسام، ومن أين تبدأ عملية التكامل.

إرشادات API

إرشادات API: بنية الطلبات وعناوين URI، والمصادقة باستخدام OAuth 2.0 (Client Credentials)، وطرق HTTP، ورموز الحالة، وبنية كل استجابة.

Just Entrance

يمكن استخدام أجهزة ADITUS مع مزوّدي تسجيل خارجيين. يوضّح هذا القسم الطرق المختلفة لربط الأنظمة الخارجية وتوفير تجربة دخول سلسة للزوّار.

مثال: استورد التذاكر الخارجية، وطابقها تلقائيًا، واجعلها جاهزة للدخول فورًا.

Just Entrance: حالة الاستخدام ←

شراء التذاكر والتسجيل

تغطي Shop API جميع عمليات المتجر: العثور على المنتجات والموارد، وإدارة المستخدمين وسلة التسوق وعملية الشراء؛ وتُستخدم Discovery لاكتشاف إعدادات النظام.

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

شراء التذاكر والتسجيل: حالة الاستخدام ←

Byndr

Byndr هي واجهة API للمنتجات تتيح اتصالات آمنة وسلسة بين المشاركين في الفعالية عبر مسح رمز QR على الشارة، سواء في اتجاه واحد أو في الاتجاهين.

الاستبيانات

يُستخدم الاستبيان لجمع البيانات بصورة منهجية من خلال مجموعة من الأسئلة المخصّصة لجمع معلومات محددة من الزوّار، مع دعم النماذج الديناميكية.

الأصول

توفّر Assets API المحتوى الثابت للمنصة: الصور والأيقونات، وتذاكر PDF والإيصالات، إضافةً إلى بيانات السمة مثل الشعارات واللافتات والألوان، حسب السياق.

يوضح العرض المباشر كيفية جلب assets واستخدامها.

فتح العرض المباشر ←

Webhooks

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

مثال: يؤدي المسح عند الدخول إلى إطلاق Webhook في الوقت الفعلي، فتبدأ Salesforce وHubSpot وغيرها إجراءات المتابعة تلقائيًا.

Webhooks: حالة الاستخدام ←

ذكاء الأعمال

خلاصة OData v4 للقراءة فقط تمنحك كل ما يعرفه نظام التذاكر لديك على شكل أربع مجموعات بيانات جاهزة للتحليل، مصمّمة للتحميل المجمّع إلى مستودع البيانات الخاص بك.

مثال: يقرأ الاستخراج لديك المبيعات وعمليات المسح من بيانات حيّة إلى مستودع بياناتك عبر OData v4، لتظهر في لوحة المعلومات أثناء انعقاد المعرض.

ذكاء الأعمال: حالة الاستخدام ←

عرض جميع الأقسام ←

Live-Demo

اختبر API مباشرةً وعمليًا.

يرشدكم العرض المباشر عبر فعالية معرض مكتملة النموذج، تشمل التشكيلات والتذاكر وسلة التسوق والتسجيل — وتعرض كل خطوة طلب API الحقيقي والاستجابة المباشرة، من دون الحاجة إلى بطاقة.

فتح العرض المباشر