كيفية إنشاء رمز API واستخدامه

تتيح رموز API لنظام آخر الاتصال بحسابك في TicketingHub. يجب أن تملك صلاحيات المسؤول لإدارتها.

ما استخدامات رمز API؟

• إرسال بيانات TicketingHub إلى برنامج لإعداد التقارير أو إلى مستودع بيانات.
• السماح لمنصة شريك مخصصة بقراءة المنتجات والأسعار.
• إنشاء تجربة حجز من جانب الخادم تتحقق من التوافر المباشر.

لا ينشئ رمز API اتصالًا مدمجًا مع Google Sheets. راجع كيفية تصدير بيانات TicketingHub وربط الأدوات الأخرى للاختيار بين عمليات تصدير CSV وZapier وخطافات الويب والوصول إلى API.

تفعيل الوصول إلى API

1. انتقل إلى Settings → Features.
2. فعّل Api access.

هذا إعداد للخدمة الذاتية. بعد تفعيله، سيظهر API Tokens في الإعدادات.

إنشاء رمز

1. انتقل إلى Settings → API Tokens.
2. اختر Generate API token.
3. أدخل اسمًا يحدد النظام الذي سيستخدم الرمز.
4. اختر Supplier API (V2) لإدارة المورّد، أو Widget API للتوافر والحجز، أو OCTO API لربط الأنظمة التي تستخدم معيار OCTO.
5. إذا اخترت Supplier API (V2) أو OCTO API، يمكنك تحديد Read-only عندما يحتاج التكامل إلى عرض البيانات فقط. لا ينطبق هذا الخيار على رموز Widget API.
6. أضف تاريخ انتهاء الصلاحية إذا لزم الأمر، ثم أنشئ الرمز.
7. انسخ الرمز فورًا واحفظه بأمان. لا يظهر الرمز الكامل إلا مرة واحدة.

استخدام الرمز

أرسل الرمز في ترويسة Authorization لكل طلب API:

Authorization: Bearer YOUR_TOKEN

استخدم رموز API فقط في الأنظمة الآمنة من جانب الخادم. لا تضع الرمز في التعليمات البرمجية لموقع إلكتروني أو رسائل البريد الإلكتروني أو رسائل الدردشة أو المستندات المشتركة.

إلغاء رمز

انتقل إلى Settings → API Tokens واختر Revoke بجانب الرمز. يسري الإلغاء فورًا، لذلك سيتوقف النظام المتصل عن العمل إلى أن يستخدم رمزًا بديلًا.

أنشئ رمزًا منفصلًا لكل تكامل، ولا تمنحه إلا الصلاحيات التي يحتاج إليها، وألغِ الرموز التي لم تعد قيد الاستخدام. للحصول على تحديثات قائمة على الأحداث، قد تفضّل استخدام خطافات الويب أو تكامل Zapier.