Spider-Booking 4 integration
- Yannick Blondeau
- Christopher MEIGNIER (Unlicensed)
The integration of Spider-Booking 4 is very simple as all the parameters are in the query string (GET HTTP method)
The base URL where you have to redirect visitors is https://reservations.hotel-spider.com?hotelId=HOTEL_ID
The value of HOTEL_ID can be provided by the hotel.
Given the parameters you have about what the visitor is looking for, the following parameters are supported:
| Parameter | Type | Comment | Default value (when not supplied) |
|---|---|---|---|
| hotelId | MANDATORY string | The ID of the hotel as supplied by Hotel-Spider. | N/A |
| checkIn | ISO 8601 formatted date e.g. 2018-04-18 | The arrival date | The current date (or 1 day before checkOut date if provided) |
| checkOut | ISO 8601 formatted date e.g. 2018-04-18 | The departure date | The day after the current date (or 1 day after the checkIn date if provided) |
| nbAdults | integer | The number of adults for the stay | 1 |
| nbChildren | integer | The number of children | 0 |
| nbInfants | integer | The number of infants | 0 |
| lang | string | The requested language code. Accepted values: "ar", "bn", "cs", "da", "de", "el", "en", "es", "fr", "gu", "he", "hi", "hr", "hu", "it", "ja", "ko", "mr", "nl", "no", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "ta", "te", "th", "zh" | The default language of the hotel |
| currency | string | The requested currency. Accepted values: "EUR", "USD", "GBP", "CHF", "AED", "ARS", "AUD", "BHD", "BRL", "CAD", "CLP", "CNY", "COP", "CZK", "DKK", "HUF", "ILS", "INR", "JOD", "JPY", "KRW", "KWD", "MXN", "NOK", "OMR", "PLN", "QAR", "RON", "RUB", "SAR", "SEK", "THB", "ZAR" | The default currency of the hotel |
| promoCode | string | A predefined promotion code | none |
All parameters are optional.
If you are redirecting to Spider-Booking 4 from a HTML form, you should set the provided hotelId in a hidden input element:
<input type="hidden" name="hotelId" value="HOTEL_ID">
Examples:
- for a stay between the 1st and 3rd of June 2018 for an unknown number of guests:
https://reservations.hotel-spider.com?hotelId=HOTEL_ID&checkIn=2018-06-01&checkOut=2018-06-03 - for a stay between the 12th and 14th of July 2018 for 2 adults and 1 baby:
https://reservations.hotel-spider.com?hotelId=HOTEL_ID&checkIn=2018-06-01&checkOut=2018-06-03&nbAdults=2&nbInfants=1 - for a stay for tonight for 2 adults:
https://reservations.hotel-spider.com?hotelId=HOTEL_ID&nbAdults=2 - for a stay for for tonight, targetting the german version and EUR currency:
https://reservations.hotel-spider.com?hotelId=HOTEL_ID¤cy=EUR&lang=de - for a link with the default dates but with a promotion code:
https://reservations.hotel-spider.com?hotelId=HOTEL_ID&promoCode=PROMOCODE
Redirect user to a specific room
It is possible to redirect the user to a specific room among the results by specifying the base route like this: https://reservations.hotel-spider.com/#/HOTEL_ID/room/ROOM_ID
All other parameters are still usable.
Note: if the room is not available with the specified parameters (dates and/or occupancy), the user will be redirected to the default results list.
Cancellation form prefilled link
The URL for the cancellation form, prefilled with the booking number, is formatted as follow: https://reservations.hotel-spider.com/#/HOTEL_ID/cancel/RESERVATION_ID
The format of Spider-Booking 4 reservation IDs is SB4-XXXXXXXX
jQuery plugin
A jQuery plugin is available for an easy integration in the hotel's website. See here for more info:
https://wbe-static.hotel-spider.com/widget-doc/index.html?hotelId=00F561cc11232b52