افزودن جستوجوی هتل به وبسایت
این راهنما جستوجوی هتل، نمایش نرخها و رزرو را به سایت شما اضافه میکند و جستوجوی مکان، جستوجوی ظرفیت، اعتبارسنجی نرخ و فرایند رزرو را کنار هم میگذارد.
پیش از شروع#
- یک
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در رزرو یا سفارش: مهلت نرخ تمام شده است. دوباره اعتبارسنجی کنید.
فهرست کامل فیلدها در صفحههای مرجع هتل آمده است.