طلب الوصول إلى API

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

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

اقرأ دليل البدء السريع ←أمثلةفتح في Postman
18ms
زمن استجابة P50
99.99%
الإتاحة في 2025
565
نقاط النهاية
10
الأقسام
1 مليار+
طلب/سنة
●POST /terp/v1/import/ticketowners
curl {{API_BASE_URL}}/connect/token \
  -u $CLIENT_ID:$CLIENT_SECRET \
  -d "grant_type=client_credentials&scope=Shop"

# → returns access_token

curl {{API_BASE_URL}}/shop/v1/discovery/events \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: de-DE"
النظام التجريبي
الحالة المباشرة
جارٍ التحقق…
API…
قاعدة البيانات…
زمن الاستجابة…
آخر تحقق: —
موثوق ومتكامل لدى
Deutsche TelekomDeutsche MesseMesse FrankfurtMesse EssenMesse StuttgartDeutsche Landwirtschafts-Gesellschaft (DLG)NürnbergMesseMesse BremenMesse MünchenMesse Offenburg-OrtenauRX Global
مصمم لصنّاع القرار التقني

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

مصمم لمديري التقنية وفرق المنصات — مصادقة وتوطين و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
Quickstart

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

1

إنشاء token

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

2

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

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

3

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

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

4

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

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

curl {{API_BASE_URL}}/connect/token \
  -u $CLIENT_ID:$CLIENT_SECRET \
  -d "grant_type=client_credentials&scope=Shop"

# → returns access_token

curl {{API_BASE_URL}}/shop/v1/discovery/events \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: de-DE"
  1. يستدعي خادمكم الخلفي ADITUS:
    Token
    POST /connect/token

    تُرسل بيانات اعتماد العميل ويُعاد bearer قصير الأجل. لا تغادر الأسرار خادمكم الخلفي أبدًا.

  2. يستدعي خادمكم الخلفي ADITUS:
    اكتشاف الفعاليات
    GET /shop/v1/discovery/events

    كتالوج مترجم للفعاليات والمواعيد وتشكيلات الأسعار.

  3. يستدعي خادمكم الخلفي ADITUS:
    سلة التسوق — قابلة للتكرار بأمان
    POST /shop/v1/cart

    أنشئوا سلة التسوق وأضيفوا العناصر واربطوا المشتري. إعادة المحاولة آمنة — السلة نفسها بلا عناصر مكررة.

  4. يستدعي خادمكم الخلفي ADITUS:
    إتمام الشراء
    POST /shop/v1/cart/{id}/checkout

    ثبّتوا سلة التسوق وأتمّوا الدفع. تتضمن الاستجابة Quicodes وروابط التذاكر اللازمة للتسليم.

  5. تستدعي ADITUS خادمكم الخلفي (بصورة غير متزامنة):
    Webhookغير متزامن
    POST https://your-backend/webhook

    بعد كل عملية شراء ناجحة، تستدعي ADITUS الـ endpoint الخاص بكم بصورة غير متزامنة ومستقلة عن استجابة إتمام الشراء.

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

متجر التذاكر، مدمج أصلاً في موقعكم.

استدعاء mount()‎ واحد يدمج مسار الشراء الكامل — الاستكشاف وسلة التسوق والتسجيل وإتمام الشراء — مباشرةً في صفحتكم: من دون iframe، وبهوية علامتكم عبر design tokens، مع توطين وتجاوب جاهزين من البداية.

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

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

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

مقدمة

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

إرشادات API

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

Just Entrance

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

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

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

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

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

Byndr

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

الاستبيانات

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

الأصول

يُرجى استخدام هذه الواجهة بدلاً من Theme API القديمة. توفّر Assets API محتوى ثابتاً مثل الصور والتذاكر والإيصالات، بالإضافة إلى معلومات السمات البصرية.

نوضح لكم في العرض المباشر، من بين أمور أخرى، كيفية جلب assets واستخدامها ←

Webhooks

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

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

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

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

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