الجولات والمعالم والتجارب
تصفّح الكتالوج، وتحقّق من الإتاحة حسب التاريخ والفترة الزمنية، واحجز وسلّم القسيمة. مسار REST واحد، والأسعار بالدولار.
GET /Activity/v2/products
?city=Tbilisi
&sort=bestselling
&per_page=20محتوى الأنشطة واسع والإتاحة حسّاسة للوقت. تمنحك واجهة الأنشطة هذه كتالوجًا قابلًا للبحث، وإتاحةً حسب التاريخ والفترة مع تصفية الأوقات الماضية، ومسار حجز بسيطًا، وقسائم قابلة للتنزيل.
تغلّف واجهة الجولات والأنشطة كتالوجًا عميقًا من التجارب بإتاحة حقيقية واعية بالوقت. تتوحّد الفئات واللغات والمدد ومستويات الأسعار والمخزون لكل فترة زمنية في تدفّق واحد، فتبيع جولة مشي أو رحلة يوم بالكود نفسه الذي تستخدمه للطيران والفنادق.
ما الذي تحصل عليه
ابحث في الكتالوج حسب المدينة والفئة والسعر واللغة.
اقرأ التواريخ والفترات القابلة للحجز، وقد صُفّيت مسبقًا حسب التوقيت المحلي للنشاط.
أنشئ حجزًا وأكّده ثم نزّل القسيمة.
تُصفّى الإتاحة وفق التوقيت المحلي لكل نشاط، فلا تظهر الفترات الماضية أبدًا.
قسائم قابلة للتنزيل وحدث لحالة الحجز يمكنك الاشتراك فيه بدل الاستقصاء.
كيف يسير التدفّق
Browse
Search the catalogue by city, category, price, or language.
Availability
Read bookable dates, then timeslots for a chosen date.
Book
Create a booking for a product-type and traveller mix.
Voucher
Confirm and download the voucher, or watch the status event.
أهم نقاط النهاية
/Activity/v2/productsSearch the activity catalogue./Activity/v2/availability/datesList bookable dates for a product./Activity/v2/availability/timeslotsList timeslots for a chosen date./Activity/v2/bookingsCreate a booking./Activity/v2/bookings/{id}/voucherDownload the voucher.الطلب والاستجابة
GET /Activity/v2/products
?city=Tbilisi
&sort=bestselling
&per_page=20{
"products": [
{
"productId": "ACT-4410",
"title": "Old Town Walking Tour",
"durationMinutes": 120,
"from": { "amount": 29.00, "currency": "USD" },
"productTypes": [
{ "code": "ADULT", "label": "Adult ticket" }
]
}
]
}ماذا تتضمّن الاستجابة
productId- Stable id for the activity.
productTypes- Bookable variants, such as ticket tiers or packages.
from- Lead-in price, in USD.
durationMinutes- Length of the experience.
cancellationPolicy- Free-cancellation window, if any.
نشاط في وجهات حول العالم
الأسئلة الشائعة
كيف تُعاد الإتاحة؟
كتواريخ قابلة للحجز، وكفترات زمنية لتاريخ مختار. ما مضى يُزال حسب التوقيت المحلي للنشاط.
ما هو product-type؟
نسخة قابلة للحجز من المنتج، مثل فئة تذكرة أو باقة. تحجز عبر معرّفها.
متى أحصل على القسيمة؟
بمجرد إصدار الحجز. يمكنك مراقبة حدث حالة الحجز بدلًا من الاستطلاع المتكرر.
كيف تعمل product-type؟
product-type نوعٌ قابل للحجز، مثل تذكرة بالغ أو باقة. تحجز عبر كوده مع تركيبة المسافرين.
هل أحصل على حالة الحجز مباشرة؟
نعم. اشترك في حدث حالة الحجز واحصل على القسيمة فور إصدار الحجز، دون استقصاء.
ابنِ منتج سفرك على واجهة واحدة.
الربط مجاني. 1% لكل تذكرة مُصدَرة بحدٍّ أقصى 10 دولارات. تغطية حية للطيران والفنادق والأنشطة.