رفتن به محتوای اصلی

وب‌سرویس تور و تفریحات

گشت شهری، تور یک‌روزه، بلیت پارک و جاذبه‌های مقصدهای پرطرفدار را کنار پرواز و هتل بفروشید. ظرفیت روزانه و سانس‌ها را ببینید، رزرو کنید و واچر را همان لحظه تحویل بدهید.

چرخهٔ کامل در API
  1. ۱ کاتالوگ
  2. ۲ ظرفیت
  3. ۳ رزرو
  4. ۴ تأیید
  5. ۵ واچر

۲٬۵۰۰+

تور و تفریح در مقصدهای خارجی

قابلیت‌ها

هر چیزی که برای فروش تور، گشت و بلیت جاذبه لازم دارید

بدون منطق جداگانه برای هر تأمین‌کننده؛ یک قرارداد پاسخ، یک مدل خطا و یک چرخهٔ سفارش.

۰۱

کاتالوگ قابل جست‌وجو

محصولات را بر اساس مقصد، دسته و کلیدواژه پیدا کنید؛ با عکس، توضیحات، مدت و محل ملاقات.

۰۲

ظرفیت روزانه و سانس

برای هر نوع محصول، روزها و سانس‌های آزاد و قیمت هر رده (بزرگسال، کودک، سالمند) را بگیرید.

۰۳

گزینه‌های رزرو

اطلاعات اضافه‌ای که هر محصول لازم دارد (مثل محل سوارشدن یا شمارهٔ پاسپورت) به‌صورت ساختاریافته اعلام می‌شود.

۰۴

رزرو و تأیید

رزرو را ثبت کنید و پس از پرداخت تأیید کنید؛ وضعیت هر رزرو همیشه از API قابل پیگیری است.

۰۵

واچر قابل دانلود

واچر PDF هر رزرو را مستقیم دانلود کنید و به ایمیل یا اپ مسافر بفرستید.

۰۶

فروش مکمل

کنار بلیت و هتل، تفریحات مقصد را پیشنهاد بدهید و سبد خرید هر مسافر را بزرگ‌تر کنید.

مسیرهای API

مسیرهای HAPI v3

همهٔ درخواست‌ها با توکن Bearer احراز می‌شوند و درخواست‌های ثبت و صدور کلید Idempotency-Key می‌پذیرند.

آدرس پایهhttps://api.simorghapi.com/v3/HAPI
متدمسیرکاربرد
GET/activities/productsفهرست و جست‌وجوی محصولات
GET/activities/products/{id}جزئیات محصول و انواع آن
GET/activities/product-types/{id}/availabilityظرفیت روزانه و سانس‌ها
POST/activities/bookingsثبت رزرو
POST/activities/bookings/{id}/confirmتأیید رزرو
GET/activities/bookingsفهرست رزروها
GET/activities/bookings/{id}جزئیات رزرو
GET/activities/bookings/{id}/vouchersفهرست واچرها
GET/activities/bookings/{id}/vouchers/{voucher}/downloadدانلود واچر PDF
POST/activities/bookings/{id}/cancelلغو رزرو

نمونهٔ درخواست

/activities/bookings
curl -X POST https://api.simorghapi.com/v3/HAPI/activities/bookings \
  -H "Authorization: Bearer $SIMORGH_TOKEN" \
  -H "Idempotency-Key: 7c1e9a52-booking-001" \
  -H "Content-Type: application/json" \
  -d '{
    "product_type_id": "apt_3f9c2d",
    "date": "2026-11-20",
    "travelers": { "adults": 2 },
    "customer": {
      "given_name": "Sara",
      "family_name": "Ahmadi",
      "email": "sara@example.com"
    }
  }'

نمونهٔ پاسخ

201 Created · application/json
{
  "object": "activity_booking",
  "id": "abk_51d0e7",
  "status": "reserved",
  "product_id": "act_8a21c4",
  "product_type_id": "apt_3f9c2d",
  "date": "2026-11-20",
  "travelers": { "adults": 2 },
  "total": { "amount": "96.00", "currency": "USD" }
}

همه‌چیز در سندباکس قابل امتحان است. همین درخواست‌ها را با کلید تست بفرستید؛ صدور شبیه‌سازی می‌شود.

راهنمای کامل
سؤال دارید؟

پرسش‌های وب‌سرویس تور و تفریحات

اگر جواب سؤال‌تان اینجا نیست، تیم ما در ساعات کاری پاسخ‌گوست.

با ما حرف بزنید۰۲۱-۹۱۳۰۲۱۵۸
تماس

گشت‌های شهری، تورهای یک‌روزه، بلیت پارک‌ها و جاذبه‌ها و تجربه‌های محلی در مقصدهای پرطرفدار خارجی. هر محصول یک یا چند نوع (مثلاً سانس صبح و عصر) دارد.

امروز کلید سندباکس بگیرید، این هفته اولین جست‌وجو را بزنید.

ثبت‌نام رایگان است و تا وقتی صدوری نداشته باشید هزینه‌ای پرداخت نمی‌کنید.