Μετάβαση στο περιεχόμενο
Ζωντανή επίδειξη

Ξενοδοχεία

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
    • countryCodestringμπορεί να είναι null
    • cityCodestringμπορεί να είναι null

      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
  • nationalitystringμπορεί να είναι null

    Guest nationality, ISO 3166-1 alpha-2.

  • Filters
    • starsinteger (int32)[]μπορεί να είναι null
    • refundableOnlybooleanμπορεί να είναι null
    • mealIncludedbooleanμπορεί να είναι null
    • priceMinnumber (double)μπορεί να είναι null
    • priceMaxnumber (double)μπορεί να είναι null
  • sortstringμπορεί να είναι null

    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
  • starFacetsobjectμπορεί να είναι null
  • HotelResult[]
    • hotelCodestring
    • namestringμπορεί να είναι null
    • starsinteger (int32)μπορεί να είναι null
    • cityCodestringμπορεί να είναι null
    • cityNamestringμπορεί να είναι null
    • countryCodestringμπορεί να είναι null
    • addressstringμπορεί να είναι null
    • latitudenumber (double)μπορεί να είναι null
    • longitudenumber (double)μπορεί να είναι null
    • imagesstring[]
    • amenitiesstring[]
    • Money

      Money on the wire: decimal string (never a float) + ISO 4217.

    • HotelRoom[]
  • 400Bad RequestΛεπτομέρειες προβλήματος RFC 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"