सामग्री पर जाएँ
लाइव डेमो

होटल

Book a rate. Requires an `Idempotency-Key` header.

post/v1/hotels/bookings

  • प्रमाणीकरण आवश्यक
  • Idempotency-Key आवश्यक

अनुरोध बॉडीHotelBookingCreateRequest

  • rateKeystring
  • BookingRoom[]
    • Guest[]
  • HolderInfo
    • firstNamestring
    • lastNamestring
    • emailstring
    • phonestring
  • specialRequestsstringnull हो सकता है
उदाहरण
{
  "rateKey": "string",
  "rooms": [
    {
      "guests": [
        {
          "type": "string",
          "gender": "string",
          "firstName": "string",
          "lastName": "string"
        }
      ]
    }
  ],
  "holder": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "phone": "string"
  },
  "specialRequests": "string"
}

प्रतिक्रियाएँ

201CreatedHotelBooking

  • bookingIdstring
  • bookingReferencestringnull हो सकता है
  • statusstring

    confirmed | pending | cancelled | unknown.

  • hotelCodestringnull हो सकता है
  • hotelNamestringnull हो सकता है
  • cityNamestringnull हो सकता है
  • roomTypestringnull हो सकता है
  • checkInstringnull हो सकता है
  • checkOutstringnull हो सकता है
  • Money

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

    • amountstring
    • currencystring
  • refundablebooleannull हो सकता है
  • priceChangedboolean
  • HolderInfo
    • firstNamestring
    • lastNamestring
    • emailstring
    • phonestring
  • BookingRoom[]
    • Guest[]
  • specialRequestsstringnull हो सकता है
  • confirmedAtstring (date-time)null हो सकता है
  • 402Payment RequiredRFC 7807 समस्या विवरण
  • 409ConflictRFC 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='{
  "rateKey": "string",
  "rooms": [
    {
      "guests": [
        {
          "type": "string",
          "gender": "string",
          "firstName": "string",
          "lastName": "string"
        }
      ]
    }
  ],
  "holder": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "phone": "string"
  },
  "specialRequests": "string"
}'
TS=$(date +%s)
NONCE=$(openssl rand -hex 16)
BODY_HASH=$(printf '%s' "$BODY" | openssl dgst -sha256 | sed 's/^.* //')
CANON=$(printf 'POST\n/v1/hotels/bookings\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/bookings" \
  -H "X-API-Key: $KEY_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIG" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "$BODY"