This endpoint needs to be implemented by partners connecting to Holidu’s API and willing to have their properties bookable on Holidu. Holidu will send a request asking for the availability status of a property for a specific stay. The partners need to answer whether the property is available or not. Please send the urls to these endpoints to partnersupport@holidu.com
AvailabilityRequest
This is a GET request that we will send to know whether the property is available or not. It contains the following parameters:
Field | Type | Required | Content |
apartmentId | string | true | Apartment ID in your system |
arrival | localDate: YYYY-MM-DD | true | When the customer would check in |
departure | localDate: YYYY-MM-DD | true | When the customer would check out |
Example
In this example, https://your-endpoint-url.com/availability-request this will be the configurable part of the URL where you can provide us the URL of your availability endpoint. The rest of the URL ?apartmentId=123abc&arrival=2020-12-23&departure=2020-12-30&provider=XYZ will always have this fixed format.
AvailabilityResponse
You should respond to the AvailabilityRequest with the following HTTP status codes:
HTTP Status Code | Meaning |
200 OK | The property is available on those dates |
409 Conflict | The property is not available on those dates |
Warning |
---|
Please make sure to only respond with a status code of 200 if the apartment is available. Independent on any error message it will be shown as available. |
Tip |
---|
For security measures we recommend you to whitelist our IPs so that we can only do requests to you from the following IPs:
|
...