API تورها و تفریحات

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

همهٔ اندپوینت‌های تفریحات زیر مسیر Activity/v2/ قرار دارند. در این درخواست‌های GET، SessionId را به‌صورت پارامتر کوئری بفرستید. پاسخ‌ها در قالب { "data": ..., "timestamp": ... } برمی‌گردند و فهرست‌ها meta.pagination را هم دارند. قیمت‌ها به دلار آمریکا (USD) هستند.

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

GET/Activity/v2/products

دسترسی نیازمند مجوز activity_products_list

فهرستی صفحه‌بندی‌شده و قابل فیلتر که از کش محلی کاتالوگ خوانده می‌شود و به همین دلیل سریع است. برای گرفتن کل کاتالوگ در یک فراخوانی از /Activity/v2/products/all و برای درخت کشورها و شهرها از اندپوینت عمومی /Activity/v2/products/by-location استفاده کنید.

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

نام	نوع	الزامی	پیش‌فرض	توضیح
`q`	string	اختیاری	-	جست‌وجو در نام، به هر زبانی که ذخیره شده باشد. ردیف‌های منطبق، فیلد `matchedLanguage` را دارند.
`type`	string	اختیاری	-	بخشی از نام نوع محصول یا UUID نوع.
`category`	string	اختیاری	-	نام یا UUID دسته‌بندی. UUID یک دستهٔ والد، زیرشاخه‌هایش را هم شامل می‌شود.
`country`	string	اختیاری	-	فیلتر بر اساس نام کشور.
`city`	string	اختیاری	-	فیلتر بر اساس نام شهر.
`tag`	string	اختیاری	-	فیلتر بر اساس برچسب.
`language`	string	اختیاری	-	زبان عنوان‌ها، مثلاً `KO` یا `AR`.
`min_price` / `max_price`	number	اختیاری	-	بازهٔ قیمت به دلار آمریکا.
`sort`	string	اختیاری	ترتیب کاتالوگ	یکی از `price`، `-price`، `date`، `-date`، `bestselling`، `sold`، `-sold`.
`page`	integer	اختیاری	`1`	شمارهٔ صفحه، از ۱ شروع می‌شود.
`per_page`	integer	اختیاری	`50`	تعداد نتایج در هر صفحه.

curl "https://api.simorghapi.com/api/Activity/v2/products?city=Singapore&sort=bestselling&per_page=20&SessionId=8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f"

const params = new URLSearchParams({
  city: "Singapore",
  sort: "bestselling",
  per_page: "20",
  SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f"
});

const res = await fetch("https://api.simorghapi.com/api/Activity/v2/products?" + params);
const data = await res.json();

import requests

res = requests.get(
    "https://api.simorghapi.com/api/Activity/v2/products",
    params={
        "city": "Singapore",
        "sort": "bestselling",
        "per_page": 20,
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    },
)

data = res.json()

پاسخ#

فیلد	نوع	توضیح
`data`	array of object	محصولات. جزئیات در ادامه.
`meta.pagination`	object	`total`، `count`، `per_page`، `current_page`، `total_pages`.

data[] object

فیلد	نوع	توضیح
`uuid`	string	شناسهٔ محصول. برای دیدن جزئیات، آن را باز کنید.
`title`	string	عنوان محصول.
`basePrice`	number	قیمت شروع («از ...»)، به دلار آمریکا.
`cityName`	string	شهر محصول.
`image_url`	string	تصویر اصلی.
`images`	array of string	گالری کامل تصاویر.

{
  "data": [
    {
      "uuid": "97475b54-3378-4eb2-8f19-85c8b76255d8",
      "title": "Gardens by the Bay Admission",
      "basePrice": 22.00,
      "currency": "USD",
      "cityName": "Singapore",
      "image_url": "https://cdn.example.com/products/97475b54/main.jpg",
      "images": ["https://cdn.example.com/products/97475b54/1.jpg"]
    }
  ],
  "meta": { "pagination": { "total": 812, "count": 20, "per_page": 20, "current_page": 1, "total_pages": 41 } },
  "timestamp": "2026-10-15T16:24:49.648+08:00"
}

باز کردن یک محصول#

GET/Activity/v2/products/{uuid}

دسترسی نیازمند مجوز activity_products_details

اطلاعات کامل محصول را به‌صورت زنده دریافت کنید: توضیحات، تصاویر، برنامهٔ تور و قوانین. محدودیت‌های سنی و تعداد نفرات را از /Activity/v2/products/{uuid}/restrictions بخوانید.

پارامترهای مسیر#

نام	نوع	الزامی	توضیح
`uuid`	string	الزامی	شناسهٔ محصول از فهرست.

فهرست انواع قابل رزرو#

GET/Activity/v2/products/{uuid}/product-types

دسترسی نیازمند مجوز activity_product_types_list

هر محصول یک یا چند نوع محصول (product-type) دارد: سطح‌های مختلف بلیت، مدت‌زمان‌ها یا بسته‌ها. هر کدام uuid مخصوص خودش را دارد؛ همان productTypeUuid که رزرو می‌کنید. آن را به ظرفیت و رزرو ببرید.

خواندن محدودیت‌ها#

GET/Activity/v2/products/{uuid}/restrictions

دسترسی نیازمند مجوز activity_products_restrictions

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

کل کاتالوگ#

GET/Activity/v2/products/all

دسترسی نیازمند مجوز activity_products_list

همهٔ محصولات در یک فراخوانی، برای همگام‌سازی کامل محلی. همان فیلترهای فهرست را می‌پذیرد، به‌علاوهٔ full (boolean) که به‌جای خلاصه، شیء کامل هر ردیف را برمی‌گرداند. اگر per_page نفرستید، همه‌چیز برگردانده می‌شود. ساختار پاسخ { success, count, total, data } است.

کشورها و شهرها#

GET/Activity/v2/products/by-location

دسترسی عمومی، بدون نشست

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

{
  "success": true,
  "countries": 42,
  "products": 8130,
  "data": [
    {
      "country": "Singapore",
      "countryUuid": "c1a2...",
      "cities": [ { "city": "Singapore", "cityUuid": "d3f4...", "count": 812 } ],
      "total": 812
    }
  ]
}

قدم بعدی. تاریخ‌ها، سانس‌ها و قیمت‌های یک نوع محصول را با API ظرفیت بررسی کنید.

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