رفتن به محتوا
دموی زنده

هتل‌ها

Cancel a booking under its cancellation policy.

post/v1/hotels/bookings/{bookingId}/cancel

  • نیازمند احراز هویت
  • نیازمند Idempotency-Key

پارامترها

ناممحلنوعتوضیح
bookingId*مسیرstring

پاسخ‌ها

200OKHotelBooking

  • bookingIdstring
  • bookingReferencestringمی‌تواند null باشد
  • statusstring

    confirmed | pending | cancelled | unknown.

  • hotelCodestringمی‌تواند null باشد
  • hotelNamestringمی‌تواند null باشد
  • cityNamestringمی‌تواند null باشد
  • roomTypestringمی‌تواند null باشد
  • checkInstringمی‌تواند null باشد
  • checkOutstringمی‌تواند null باشد
  • Money

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

    • amountstring
    • currencystring
  • refundablebooleanمی‌تواند null باشد
  • priceChangedboolean
  • HolderInfo
    • firstNamestring
    • lastNamestring
    • emailstring
    • phonestring
  • BookingRoom[]
    • Guest[]
  • specialRequestsstringمی‌تواند null باشد
  • confirmedAtstring (date-time)می‌تواند null باشد

نمونه کدها

برنامه‌های کاملی که درخواست را دقیقاً به همان روشی امضا می‌کنند که درگاه آن را بررسی می‌کند. 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=''
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/b216bGJ5bG1BMURGMVFadERnPT0/cancel\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/b216bGJ5bG1BMURGMVFadERnPT0/cancel" \
  -H "X-API-Key: $KEY_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIG" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Accept: application/json"