بحث الفنادق والأسعار والحجز
حلّل الوجهة، واعرض الفنادق، وتحقّق من السعر ثم أكّد. مسار REST واحد، والأسعار بالدولار.
{
"CheckIn": "2026-11-14",
"CheckOut": "2026-11-16",
"CityId": 11111111456928,
"Occupancies": [ { "AdultCount": 2 } ],
"Sort": "price"
}مخزون الفنادق ضخم والأسعار تتغيّر بسرعة. تمنحك واجهة الإقامة هذه بحثًا عامًّا عن الأماكن، وإتاحةً بنمط المدينة والفندق، وتحققًا من السعر بنافذة حجز مؤقت، ومسارًا واضحًا: احجز أولًا ثم أكّد.
تقف واجهة إقامة واحدة أمام ملايين المنشآت، من السلاسل العالمية إلى الفنادق البوتيكية المستقلة. تصل الإتاحة وأنواع الإعاشة وسياسات الإلغاء والضرائب بشكل واحد وعملة واحدة، فلا يحتاج موقع أو تطبيق حجز الفنادق إلى التوفيق بين عشرات صيغ المورّدين.
ما الذي تحصل عليه
يتّصل البحث العام عن الأماكن مباشرةً بحقل إكمال تلقائي.
نقطة إتاحة واحدة تعرض مدينة كاملة أو تفتح فندقًا واحدًا بغُرَفه.
تحقّق من السعر، واحجز الغرفة مؤقتًا، ثم أكّد واخصم، كل ذلك بالدولار.
بحث بالمدينة وبالفندق من نقطة نهاية واحدة، من وجهة كاملة إلى منشأة واحدة.
يفتح التحقّق من السعر نافذة حجز قصيرة، فيكون السعر الذي تعرضه هو سعر الحجز.
كيف يسير التدفّق
Resolve
Turn a destination string into a place id with public place search.
Search
List availability for a whole city, or open a single property with its rooms.
Validate
Confirm the live rate and open a short hold window.
Book
Place the order and confirm; your balance is charged on confirmation.
أهم نقاط النهاية
/Hotel/PlaceSearchResolve a destination into a place id./v2/Hotel/HotelAvailabilityList availability in city or hotel mode./Hotel/RateValidateValidate the selected rate and hold it./Hotel/HotelBookCreate and confirm the booking./Hotel/BookingDetailsRetrieve a booking and its status.الطلب والاستجابة
{
"CheckIn": "2026-11-14",
"CheckOut": "2026-11-16",
"CityId": 11111111456928,
"Occupancies": [ { "AdultCount": 2 } ],
"Sort": "price"
}{
"hotels": [
{
"hotelId": "HTL-9931",
"name": "Marina Suites",
"stars": 4,
"lowestRate": {
"amount": 180.00, "currency": "USD", "board": "BB"
},
"rooms": [ { "code": "DLX-K", "refundable": true } ]
}
]
}ماذا تتضمّن الاستجابة
hotelId- Stable id for the property.
lowestRate- Cheapest bookable rate, in USD, with board type.
rooms- Room options with codes and refundability.
cancellationPolicy- Deadlines and penalties that apply to the rate.
hold- Minutes the validated rate stays bookable.
فندق حول العالم
الأسئلة الشائعة
كيف أحوّل وجهة إلى بحث؟
استدعِ البحث العام عن الأماكن لتحويل النص إلى معرّف، ثم مرّر المعرّف إلى الإتاحة.
كم تدوم صلاحية السعر بعد التحقق؟
خمس عشرة دقيقة. احجز خلال هذه النافذة باستخدام كود السعر المُعاد.
متى يُخصم من رصيدي؟
فقط عند تأكيد الطلب. الحجز يحتفظ بالغرفة دون خصم.
هل تشمل الأسعار الضرائب والرسوم؟
نعم. يحمل كل سعر العملة ونوع الإعاشة وتفصيل الضرائب والرسوم، وكلها موحّدة بالدولار.
هل يمكنني فتح منشأة واحدة مباشرة؟
نعم. يفتح وضع الفندق منشأة واحدة بغرفها، بينما يسرد وضع المدينة وجهة كاملة.
ابنِ منتج سفرك على واجهة واحدة.
الربط مجاني. 1% لكل تذكرة مُصدَرة بحدٍّ أقصى 10 دولارات. تغطية حية للطيران والفنادق والأنشطة.