مرور تفریحات

کاتالوگ تفریحات شامل تورها، جاذبه‌ها و تجربه‌های گردشگری است. آن را مرور کنید تا محصول موردنظر را پیدا کنید و سپس محصول را باز کنید تا انواع قابل‌رزرو (product-type) و قیمت‌هایش را ببینید.

فهرست محصولات#

GET/v3/HAPI/activities/products

به اسکوپ activities:read نیاز دارد.

پارامترهای کوئری#

نام	نوع	توضیح
`query`	string	جست‌وجوی متنی آزاد در عنوان‌ها.
`city`	string	فیلتر بر اساس شهر.
`country`	string	فیلتر بر اساس کشور.
`category`	string	فیلتر بر اساس دسته‌بندی.
`language`	string	زبان ترجیحی محتوا.
`min_price`، `max_price`	number	بازهٔ قیمت به دلار آمریکا (USD).
`sort`	string	ترتیب نمایش، مثلاً `bestselling` یا `price`.
`page`، `per_page`	integer	صفحه‌بندی (پیش‌فرض `per_page` برابر 50).

curl "https://api.simorghapi.com/v3/HAPI/activities/products?city=Tbilisi&sort=bestselling" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

پاسخ#

{
  "object": "activity_product_list",
  "data": [
    {
      "object": "activity_product",
      "id": "act_4410",
      "title": "Old Town Walking Tour",
      "type": "Walking tour",
      "city": "Tbilisi",
      "from": { "amount": "29.00", "currency": "USD" },
      "image_url": "https://…",
      "images": [ "https://…" ]
    }
  ],
  "page": 1,
  "per_page": 50,
  "total": 128,
  "has_more": true
}

دریافت یک محصول#

GET/v3/HAPI/activities/products/{id}

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

{
  "object": "activity_product",
  "id": "act_4410",
  "title": "Old Town Walking Tour",
  "description": "…",
  "city": "Tbilisi",
  "country": "Georgia",
  "images": [ "https://…" ],
  "product_types": [
    {
      "object": "activity_product_type",
      "id": "apt_88213",
      "title": "Adult ticket",
      "from": { "amount": "29.00", "currency": "USD" }
    }
  ]
}

قیمت‌ها به دلار آمریکا (USD) هستند. قیمت‌های کاتالوگ، قیمت شروع («از …») هستند. پیش از رزرو، قیمت واقعی هر مسافر برای تاریخ موردنظر را از ظرفیت و قیمت بخوانید.

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