BookyFlow has built-in functionality that supports Oauth2 REST API endpoints. These endpoints allow remote services such as apps to communicate with individual BookyFlow installations, if those installations can install API Feature plugins.
This documentation refers to the basic REST API functionality that can be installed through the BookyFlow Plugin Manager.
--
There are two flavours of REST API endpoints, either BookyFlow Core, or Channel Management Framework. Which you use depends on your requirements.
Additionally there is the Booking API which allows you to make bookings through the API.
BookyFlow Core endpoints are the original set of endpoints and they reflect basic functionality within BookyFlow. To access these endpoints all you need is a Client ID and Secret to request a token. The Client ID/Secret pair are available to a manager via the frontend.
Channel Management Framework (CMF) endpoints are designed to work within the context of the requesting client being a Channel ( OTA/PMS/CM ). Like the Core method above a Client ID/Secret pair needs to be created and a token requested. Once that token has been sent then the client will announce themselves using the Announce endpoint. The purpose of this is so that a manager can allow multiple channels to connect to their account and those channels can only access the properties that they have created. Once the calling Channel has announced themselves then they must include X-BOOKYFLOW-channel-name and the channel name in the header of their request, as well as the token.
CMF endpoints offer more in the way of functionality and are more suited to Channel Management requirements.
--
You can find technical information, including examples on how to build your own API features on the manual.
Replace @variable_name in these docs with the relevant data required, so @property_id reflects the property uid of the property to be queried.
Dates need to be sent in YYYY-MM-DD format.
This REST API respects the philosophy that different request methods should mirror different activities, therefore POST methods add records, DELETE methods remove records, PUT methods update records, and GET methods are used to pull information from the REST API.
When an API key/secret pair are created, the key is given access to certain "scopes" which gives that particular key pair rights to certain activities. The "scope" is defined in each plugin's scopes.json file.
Auth-Free features are API features that do not require a REST API key pair to access the API endpoints. Features marked by a * are Auth-Free.
The BookyFlow REST API is organized into several main sections:
https://yourdomain.com/bookyflow/apiReplace yourdomain.com with your actual BookyFlow installation domain.
For technical information and examples on how to build your own API features, visit the BookyFlow Developer Guide.