وب‌سرویس هتل
از جستوجوی شهر تا رزرو قطعی اتاق، با فیلتر و مرتب‌سازی سمت سرور، نرخهای قابل رزرو و قوانین لغو شفاف. هتلهای داخلی و خارجی را در سایت یا اپ خودتان بفروشید.
- ۱ جستوجو
- ۲ نرخ اتاق
- ۳ ثبت سفارش
- ۴ تأیید
- ۵ واچر
۵ میلیون+
هتل در سراسر دنیا
هر چیزی که برای فروش هتل داخلی و خارجی لازم دارید
بدون منطق جداگانه برای هر تأمین‌کننده؛ یک قرارداد پاسخ، یک مدل خطا و یک چرخهٔ سفارش.
دو حالت جستوجو
در حالت شهری خلاصهٔ هتلها با کمترین قیمت، فیلترها و تعداد هر فیلتر را می‌گیرید؛ با انتخاب هتل، نرخهای قابل رزرو همان هتل برمی‌گردد.
فیلتر و مرتب‌سازی سمت سرور
ستاره، نوع اقامت، محدودهٔ قیمت و امکانات روی کل نتایج شهر اعمال می‌شود، نه فقط صفحهٔ جاری؛ صفحه‌بندی هم آماده است.
بازبینی و نگهداری نرخ
نرخ انتخاب‌شده را پیش از پرداخت بازبینی میکنید و تا پایان مهلت نگهداری، قیمت برای مسافر ثابت میماند.
رزرو دومرحله‌ای
اول سفارش را ثبت میکنید، بعد از پرداخت مسافر تأیید میکنید. اگر لازم شد، مهلت تأیید را تمدید کنید.
قوانین لغو پیش از خرید
جریمهٔ لغو و مهلت لغو رایگان هر نرخ در پاسخ می‌آید و پیش از لغو، مبلغ دقیق را استعلام میکنید.
اتاق‌های چندگانه
چند اتاق با ترکیب متفاوت بزرگسال و کودک (با سن هر کودک) را در یک درخواست جستوجو و رزرو کنید.
مسیرهای HAPI v3
همهٔ درخواست‌ها با توکن Bearer احراز میشوند و درخواست‌های ثبت و صدور کلید Idempotency-Key می‌پذیرند.
https://api.simorghapi.com/v3/HAPI| متد | مسیر | کاربرد |
|---|---|---|
| GET | /hotels/places | جستوجوی شهر و هتل |
| POST | /hotels/searches | جستوجوی هتل و نرخ اتاق |
| GET | /hotels/rates/{id} | بازبینی نرخ پیش از رزرو |
| POST | /hotels/orders | ثبت سفارش هتل |
| POST | /hotels/orders/{id}/confirm | تأیید قطعی رزرو |
| POST | /hotels/orders/{id}/extend-deadline | تمدید مهلت تأیید |
| GET | /hotels/orders/{id} | جزئیات و وضعیت سفارش |
| GET | /hotels/orders/{id}/cancellation | استعلام جریمهٔ لغو |
| POST | /hotels/orders/{id}/cancellation | لغو رزرو |
نمونهٔ درخواست
curl -X POST https://api.simorghapi.com/v3/HAPI/hotels/searches \
-H "Authorization: Bearer $SIMORGH_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"city_id": 1043,
"check_in": "2026-11-12",
"check_out": "2026-11-15",
"occupancies": [{ "adults": 2, "children": [6] }],
"page_size": 20
}'نمونهٔ پاسخ
{
"object": "hotel_search",
"id": "hsr_99120",
"mode": "city",
"check_in": "2026-11-12",
"check_out": "2026-11-15",
"nights": 3,
"total": 214,
"offers": [
{
"hotel": { "id": "58213", "name": "Espinas Palace", "rating": 5 },
"lead_price": { "amount": "412000000", "currency": "IRR" }
}
]
}همه‌چیز در سندباکس قابل امتحان است. همین درخواست‌ها را با کلید تست بفرستید؛ صدور شبیه‌سازی می‌شود.
محصولات دیگر را هم اضافه کنید
پرسش‌های وب‌سرویس هتل
اگر جواب سؤال‌تان اینجا نیست، تیم ما در ساعات کاری پاسخ‌گوست.
امروز کلید سندباکس بگیرید، این هفته اولین جستوجو را بزنید.
ثبت‌نام رایگان است و تا وقتی صدوری نداشته باشید هزینهای پرداخت نمی‌کنید.