مستندات

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

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

افزودن جست‌وجوی هتل به وب‌سایت

این راهنما جست‌وجوی هتل، نمایش نرخ‌ها و رزرو را به سایت شما اضافه می‌کند و جست‌وجوی مکان، جست‌وجوی ظرفیت، اعتبارسنجی نرخ و فرایند رزرو را کنار هم می‌گذارد.

پیش از شروع#

  • یک SessionId. بخش احراز هویت را ببینید.
  • مجوزهای هتل: hotel_availability، hotel_check_rate، hotel_book، hotel_order.

قدم ۱: تبدیل مقصد به شناسه#

جست‌وجوی مکان عمومی است، پس می‌توانید آن را مستقیماً به کادر تکمیل خودکار وصل کنید. external_id مکان انتخاب‌شده را نگه دارید.

curl "https://api.simorghapi.com/api/v2/Hotel/cities/search?q=paris&type=city"

قدم ۲: فهرست هتل‌ها#

مکان را برای تاریخ‌های اقامت و تعداد مهمانان جست‌وجو کنید. نتایج را نمایش دهید و امکان فیلتر و مرتب‌سازی را به کاربر بدهید.

curl -X POST https://api.simorghapi.com/api/v2/Hotel/HotelAvailability \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-...",
    "CheckIn": "2026-10-15", "CheckOut": "2026-10-16",
    "CityId": 11111111456928,
    "Occupancies": [ { "AdultCount": 2 } ],
    "Sort": "price"
  }'

قدم ۳: باز کردن هتل و انتخاب اتاق#

همان اندپوینت را دوباره با CityId برابر null و HotelId انتخاب‌شده فراخوانی کنید. هر نرخ اتاق یک FareSourceCode دارد؛ کدِ نرخی را که مسافر انتخاب می‌کند نگه دارید.

curl -X POST https://api.simorghapi.com/api/v2/Hotel/HotelAvailability \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-...",
    "CheckIn": "2026-10-15", "CheckOut": "2026-10-16",
    "CityId": null, "HotelId": 7825691,
    "Occupancies": [ { "AdultCount": 2 } ]
  }'

قدم ۴: اعتبارسنجی نرخ#

در مرحلهٔ پرداخت، قیمت اتاق را دوباره بگیرید. نرخ اعتبارسنجی‌شده ۱۵ دقیقه معتبر است. رزرو را با FareSourceCodeـی انجام دهید که این فراخوانی برمی‌گرداند.

curl -X POST https://api.simorghapi.com/api/v2/Hotel/HotelCheckRate \
  -H "Content-Type: application/json" \
  -d '{ "SessionId": "8f3c81d2-...", "FareSourceCode": "YmE6OTk4MjE6cnI3ZjMy" }'

قدم ۵: رزرو، سپس ثبت سفارش#

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

# hold
curl -X POST https://api.simorghapi.com/api/v2/Hotel/HotelBook \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-...", "FareSourceCode": "YmE6OTk4MjE6cnI3ZjMy",
    "PhoneNumber": "+441234567890", "Email": "traveller@example.com",
    "Rooms": [ { "Passengers": [ { "FirstName": "Jane", "LastName": "Doe", "PassengerType": 1, "PassengerTitle": 2 } ] } ],
    "HotelTransfers": []
  }'

# confirm and charge
curl -X POST https://api.simorghapi.com/api/v2/Hotel/HotelOrder \
  -H "Content-Type: application/json" \
  -d '{ "SessionId": "8f3c81d2-...", "UniqueId": "HB-2026-004417" }'

مدیریت خطاهای رایج#

  • Err0201003 در جست‌وجوی ظرفیت: دقیقاً یکی از CityId یا HotelId را بفرستید.
  • Err0102003 در رزرو یا سفارش: مهلت نرخ تمام شده است. دوباره اعتبارسنجی کنید.

فهرست کامل فیلدها در صفحه‌های مرجع هتل آمده است.

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