হোটেল

Search hotels by city code (IATA-style, e.g. DXB — see /v1/content/cities), by hotel codes from your stored catalogue, or by a geo circle. Returns a session to poll, or the complete result when `wait` is true.

post/v1/hotels/search

প্রমাণীকরণ প্রয়োজন

রিকোয়েস্ট বডি`HotelSearchRequest`

DestinationSpec
- countryCodestringnull হতে পারে
- cityCodestringnull হতে পারে
  Platform city code (see /v1/content/cities).
- hotelCodesstring[]null হতে পারে
  Canonical hotel codes (see /v1/content/hotels).
- Geo
checkInstring
yyyy-MM-dd.
checkOutstring
SearchRoom[]
- adultsinteger (int32)
- childrenAgesinteger (int32)[]null হতে পারে
nationalitystringnull হতে পারে
Guest nationality, ISO 3166-1 alpha-2.
Filters
- starsinteger (int32)[]null হতে পারে
- refundableOnlybooleannull হতে পারে
- mealIncludedbooleannull হতে পারে
- priceMinnumber (double)null হতে পারে
- priceMaxnumber (double)null হতে পারে
sortstringnull হতে পারে
price_asc | price_desc | stars_desc | name.
pageinteger (int32)
pageSizeinteger (int32)
waitboolean

উদাহরণ

{
  "destination": {
    "cityCode": "DXB"
  },
  "checkIn": "2026-11-15",
  "checkOut": "2026-11-18",
  "rooms": [
    {
      "adults": 2,
      "childrenAges": []
    }
  ],
  "wait": true
}

রেসপন্স

200OKHotelSearchResponse

searchIdstring
statusstring
cursorinteger (int32)
suppliersDoneinteger (int32)
supplierCountinteger (int32)
totalinteger (int32)
pageinteger (int32)
pageCountinteger (int32)
partialboolean
starFacetsobjectnull হতে পারে
HotelResult[]
- hotelCodestring
- namestringnull হতে পারে
- starsinteger (int32)null হতে পারে
- cityCodestringnull হতে পারে
- cityNamestringnull হতে পারে
- countryCodestringnull হতে পারে
- addressstringnull হতে পারে
- latitudenumber (double)null হতে পারে
- longitudenumber (double)null হতে পারে
- imagesstring[]
- amenitiesstring[]
- Money
  Money on the wire: decimal string (never a float) + ISO 4217.
- HotelRoom[]

400Bad RequestRFC 7807 সমস্যার বিবরণ

কোড নমুনা

সম্পূর্ণ প্রোগ্রাম, যা গেটওয়ে যেভাবে যাচাই করে ঠিক সেভাবেই রিকোয়েস্ট স্বাক্ষর করে। YOUR_KEY_ID ও YOUR_SECRET বদলে দিন।

# Sign the request: METHOD \n path+query \n unix time \n nonce \n sha256(body)
KEY_ID="YOUR_KEY_ID"
SECRET="YOUR_SECRET"
BODY='{
  "destination": {
    "cityCode": "DXB"
  },
  "checkIn": "2026-11-15",
  "checkOut": "2026-11-18",
  "rooms": [
    {
      "adults": 2,
      "childrenAges": []
    }
  ],
  "wait": true
}'
TS=$(date +%s)
NONCE=$(openssl rand -hex 16)
BODY_HASH=$(printf '%s' "$BODY" | openssl dgst -sha256 | sed 's/^.* //')
CANON=$(printf 'POST\n/v1/hotels/search\n%s\n%s\n%s' "$TS" "$NONCE" "$BODY_HASH")
SIG=$(printf '%s' "$CANON" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')

curl -X POST "https://api.dubaitrip.com/v1/hotels/search" \
  -H "X-API-Key: $KEY_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIG" \
  -H "Content-Type: application/json" \
  -d "$BODY"

রিকোয়েস্ট বডিHotelSearchRequest

রেসপন্স

কোড নমুনা

রিকোয়েস্ট বডি`HotelSearchRequest`