Skip to Content

واجهة API للمطورين

تتيح واجهة API للمطورين في TourPro لسكربتاتك وتكاملاتك الخاصة قراءة بياناتك. يعمل الوصول عبر رموز الوصول الشخصية: يتصرف كل رمز نيابةً عنك ولا يرى سوى الجولات المتاحة لك.

المرحلة الأولى للقراءة فقط: يمكنك جلب بيانات هويتك وجولاتك وأحداث الجدول.

إنشاء رمز وصول

افتح ملفك الشخصي

في تطبيق الويب، افتح الملف الشخصي (Profile) واختر تبويب Developer.

أنشئ الرمز

انقر على إنشاء رمز (Create token)، وامنحه اسماً واضحاً (مثل اسم السكربت أو الخدمة التي ستستخدمه)، ثم أكد الإنشاء.

انسخه فوراً

يعرض TourPro الرمز مرة واحدة فقط. انسخه واحفظه كما تحفظ كلمات المرور. إذا فقدته، فألغِ الرمز وأنشئ واحداً جديداً.

استدعاء الواجهة البرمجية (API)

أرسل الرمز ضمن ترويسة المصادقة بصيغة Bearer:

Authorization: Bearer tourpro_...
نقطة النهاية (Endpoint)البيانات المُرجعة
GET /api/v1/meمعرف المستخدم والاسم والبريد الإلكتروني
GET /api/v1/toursالجولات التي تملك صلاحية الوصول إليها
GET /api/v1/tours/:tourId/eventsأحداث الجدول الخاصة بجولة محددة، مصفاة حسب أذوناتك وإعدادات الرؤية

عنوان الأساس (Base URL) هو مضيف الواجهة البرمجية (مثل https://api.tourpro.app) وليس عنوان تطبيق الويب.

curl https://api.tourpro.app/api/v1/tours \ -H "Authorization: Bearer tourpro_..."

يخضع استدعاء الواجهة البرمجية لحد 120 طلباً في الدقيقة لكل رمز. عند تجاوز الحد ستتلقى استجابة 429 مع ترويسات RateLimit التي توضح النافذة الزمنية.

إلغاء رمز وصول

ارجع إلى تبويب Developer، وانقر على إلغاء (Revoke) بجانب الرمز ثم أكد الإجراء. يسري الإلغاء فوراً وبصورة نهائية؛ أنشئ رمزاً جديداً إذا احتجت إلى بديل.

ما الذي يمكن للرمز رؤيته

لا يرى الرمز إطلاقاً أكثر مما تراه أنت:

  • الجولات: فقط الجولات التي أنشأتها أو تنتمي إليها.
  • الأحداث: فقط الأحداث المرئية لدورك ولتواريخ وصول المكان في تلك الجولة، وفقط عندما تملك إذن عرض الجدول.
  • كل شيء للقراءة فقط؛ لا يمكن لأي طلب عبر الواجهة البرمجية تعديل بياناتك.

جلسات تسجيل الدخول من المتصفح لا تعمل مع الواجهة البرمجية. لا تقبل نقاط النهاية في v1 سوى الرموز التي تبدأ بالبادئة tourpro_، بحيث لا يمكن إعادة استخدام جلسة متصفح مسروقة ضدها.

Last updated on