مستندات

جست‌وجو در مستندات

نام اندپوینت، موضوع یا کلیدواژه را بنویسید

ظرفیت و قیمت تفریحات

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

ظرفیت بر اساس productTypeUuid به‌دست‌آمده از product-types خوانده می‌شود. تاریخ‌ها و سانس‌هایی که گذشته‌اند، بر اساس منطقهٔ زمانی خودِ تفریح، به‌طور خودکار حذف می‌شوند. SessionId را به‌صورت پارامتر کوئری بفرستید.

تاریخ‌های قابل رزرو#

GET/Activity/v2/product-types/{uuid}/price-lists

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

تقویم تاریخ‌های یک نوع محصول به‌همراه قیمت هر روز. با date_start و date_end بازه را محدود کنید.

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

نامنوعالزامیتوضیح
uuidstringالزامیمقدار productTypeUuid.

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

نامنوعالزامیتوضیح
date_startstringاختیاریابتدای بازه، با قالب YYYY-MM-DD.
date_endstringاختیاریانتهای بازه، با قالب YYYY-MM-DD.
curl "https://api.simorghapi.com/api/Activity/v2/product-types/5f3ff236-40b1-4f0a-a780-1db8649d1f5b/price-lists?date_start=2026-10-15&date_end=2026-10-31&SessionId=8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f"
const uuid = "5f3ff236-40b1-4f0a-a780-1db8649d1f5b";
const params = new URLSearchParams({
  date_start: "2026-10-15",
  date_end: "2026-10-31",
  SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f"
});

const res = await fetch(`https://api.simorghapi.com/api/Activity/v2/product-types/${uuid}/price-lists?` + params);
const data = await res.json();
import requests

uuid = "5f3ff236-40b1-4f0a-a780-1db8649d1f5b"
res = requests.get(
    f"https://api.simorghapi.com/api/Activity/v2/product-types/{uuid}/price-lists",
    params={
        "date_start": "2026-10-15",
        "date_end": "2026-10-31",
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    },
)

data = res.json()

پاسخ#

data آرایه‌ای از تاریخ‌هاست. هر عضو شامل date، منطقهٔ زمانی آن (timezone)، وضعیت ظرفیت و قیمت است.

{
  "data": [
    {
      "date": "2026-10-15",
      "timezone": "Asia/Singapore",
      "available": true,
      "price": 22.00,
      "currency": "USD"
    },
    {
      "date": "2026-10-16",
      "timezone": "Asia/Singapore",
      "available": true,
      "price": 22.00,
      "currency": "USD"
    }
  ],
  "timestamp": "2026-10-15T16:24:49.648+08:00"
}

یک تاریخ مشخص#

GET/Activity/v2/product-types/{uuid}/price-lists/{date}

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

قیمت و ظرفیت برای یک روز با قالب YYYY-MM-DD. اگر آن تاریخ گذشته باشد، data برابر null است.

سانس‌ها#

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

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

جزئیات نوع محصول. اگر این نوع محصول در ساعت‌های مشخصی برگزار شود، فهرست سانس‌ها در data.timeslots می‌آید. برای گرفتن سانس‌های یک روز، ?date=YYYY-MM-DD را بفرستید. سانس‌هایی که در آن روز گذشته‌اند حذف می‌شوند.

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

نامنوعالزامیتوضیح
datestringاختیاریروزی که سانس‌هایش را می‌خواهید، با قالب YYYY-MM-DD.
{
  "data": {
    "uuid": "5f3ff236-40b1-4f0a-a780-1db8649d1f5b",
    "timezone": "Asia/Singapore",
    "timeslots": [
      { "startTime": "10:00", "endTime": "11:00" },
      { "startTime": "14:00", "endTime": "15:00" }
    ]
  },
  "timestamp": "2026-10-15T09:30:00.000+08:00"
}
تاریخ‌ها و سانس‌های گذشته از قبل فیلتر شده‌اند. API زمان را با منطقهٔ زمانی محلی تفریح مقایسه می‌کند و هر چیزی را که گذشته باشد حذف می‌کند؛ پس هر سانسی که نمایش می‌دهید هنوز قابل رزرو است.
قدم بعدی. تاریخ و سانس را با API رزرو تفریحات رزرو کنید.
ویرایش این صفحه در گیت‌هابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.