API رزرو هتل

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

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

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

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

ندارد.

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

ندارد.

پارامترهای بدنه#

فیلترها#

فیلترها را به‌صورت آرایه‌ای از شناسه‌ها زیر کلیدهای نام‌دار بفرستید؛ مثلاً { "class": [4,5], "mealplan": ["breakfast_included"] }. شرط‌ها با AND ترکیب می‌شوند. هر جست‌وجو مجموعهٔ کامل کلیدهای فیلتر و شناسه‌های قابل انتخاب هر کدام را، همراه با تعداد زندهٔ نتایج (count)، در Meta.AvailableFilters برمی‌گرداند. رابط فیلتر را برای نتایج فعلی از روی همین داده بسازید.

درخواست: فهرست هتل‌های یک شهر#

curl -X POST https://api.simorghapi.com/api/v2/Hotel/HotelAvailability \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    "CheckIn": "2026-10-15",
    "CheckOut": "2026-10-16",
    "CityId": 11111111456928,
    "Occupancies": [ { "AdultCount": 2, "ChildCount": 0 } ],
    "Filters": { "class": [4, 5], "mealplan": ["breakfast_included"] },
    "Sort": "price",
    "Page": 1
  }'

const res = await fetch("https://api.simorghapi.com/api/v2/Hotel/HotelAvailability", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    CheckIn: "2026-10-15",
    CheckOut: "2026-10-16",
    CityId: 11111111456928,
    Occupancies: [ { AdultCount: 2, ChildCount: 0 } ],
    Filters: { class: [4, 5], mealplan: ["breakfast_included"] },
    Sort: "price",
    Page: 1
  })
});

const data = await res.json();

import requests

res = requests.post(
    "https://api.simorghapi.com/api/v2/Hotel/HotelAvailability",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "CheckIn": "2026-10-15",
        "CheckOut": "2026-10-16",
        "CityId": 11111111456928,
        "Occupancies": [{"AdultCount": 2, "ChildCount": 0}],
        "Filters": {"class": [4, 5], "mealplan": ["breakfast_included"]},
        "Sort": "price",
        "Page": 1,
    },
)

data = res.json()

درخواست: باز کردن یک هتل#

CityId را null بگذارید و HotelId را بفرستید. پاسخ به‌جای فهرست هتل‌ها، نرخ اتاق‌های همان هتل را برمی‌گرداند.

POST /api/v2/Hotel/HotelAvailability
{
  "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
  "CheckIn": "2026-10-15",
  "CheckOut": "2026-10-16",
  "CityId": null,
  "HotelId": 7825691,
  "Occupancies": [ { "AdultCount": 2 } ]
}

پاسخ#

نتایج در PricedItineraries برمی‌گردند. در حالت شهر هر عضو یک هتل است و در حالت هتل هر عضو یک نرخ اتاق قابل رزرو است که FareSourceCode دارد.

خطاها#