Developer Guide
Developer Guide
🧭 Smart Distribution API – Developer Overview
This suite of APIs enables seamless hotel booking workflows—from destination discovery to reservation management. Below is a quick summary of each operation and its role in the booking lifecycle.
🔍 1. GetDestinations
Purpose: Fetches a list of supported cities/regions where hotel inventory is available. Use Case: Populate search filters, dropdowns, or auto-suggestions.
🏨 2. GetBestProperty
Purpose: Searches for the best available hotel properties in a destination based on dates and occupancy. Use Case: Display hotel options to users after selecting a destination.
🛏️ 3. GetAllProducts
Purpose: Retrieves room-level details including rate plans, pricing, amenities, and cancellation policies for a selected hotel. Use Case: Show available rooms and pricing options before booking.
✅ 4. PreCheckReservation
Purpose: Validates real-time availability and pricing before finalizing a booking.
Use Case: Prevent booking failures due to rate changes or room unavailability.
Output: Returns a preBookReservationId
for use in final booking.
📦 5. CommitReservation
Purpose: Finalizes and commits the reservation to the supplier system. Use Case: Confirm booking and generate reservation reference. Includes: Guest details, payment info, and room selection.
❌ 6. CancelReservation
Purpose: Cancels an existing reservation using the original ReservationId
and ConfirmationNumber
.
Use Case: Enable users to cancel bookings and receive cancellation confirmation.
⚠️ Error Handling
Standard HTTP error codes (400, 401, 403, 406, 415, 500) are used for validation, authentication, and system issues.
Tip: Always validate responses and handle status
flags gracefully.
🛠️ Integration Notes
All endpoints use HTTPS
Dates must be in ISO format (
YYYY-MM-DD
)Replace
[SD-Domain]
with your actual API domainContact RateGain Integration Team for credentials and support
Last updated