Bookio Rental Public API (1.0)
Download OpenAPI specification:Download
This API is documented in OpenAPI format. It's still a work in progress so please let us know about any issues at dev@bookio.com.
Token based authentication. Access to bookio API with specific channel assigned to the token.
| ErrorCode | Description |
|---|---|
| 10 | Generic validation error, errors field will give more information |
| 11 | Payment error, reservation cannot be marked as paid |
| 20 | Invalid token or missing access rights |
| 30 | Cars are occupied |
| 40 | Duplicate reservation |
| 404 | Not found |
| 666 | Unspecified internal error, this will be reported to us and we will look into it shortly |
Get facility by GID
Returns facility by GID if you have enough access rights
Authorizations:
path Parameters
| Gid required | string Example: abc123 Global ID of facility |
Responses
Successful operation
Bad request
Staging server.
Production server.
Response samples
- 200
- 400
{- "result": {
- "success": true,
- "data": {
- "bookioId": 123,
- "name": "Some facility",
- "gid": "abc123",
- "timeZone": "Europe/Bratislava",
- "address": {
- "street": "Second street",
- "city": "Bratislava",
- "postcode": 82104,
- "country": {
- "name": "Slovakia",
- "code": "SVK"
}, - "gps": {
- "latitude": 48.152115,
- "longitude": 17.108769
}
}
}
}
}List of facilities by access token
Returns facilities by access rights
Authorizations:
query Parameters
| offset | integer >= 0 Default: 0 Example: offset=50 Determines the offset within pagination. |
| limit | integer [ 0 .. 100 ] Default: 100 Example: limit=50 Limits the result set. |
Responses
Successful operation
Bad request
Staging server.
Production server.
Response samples
- 200
- 400
{- "result": {
- "success": true,
- "data": {
- "pagination": {
- "total": 1234,
- "offset": 100,
- "limit": 100
}, - "facilities": [
- {
- "name": "Car rental",
- "gid": "abc123"
}
]
}
}
}List of facility networks
Returns facility networks
Authorizations:
Responses
Successful operation
Bad request
Staging server.
Production server.
Response samples
- 200
- 400
{- "result": {
- "success": true,
- "data": [
- {
- "name": "Car rent group",
- "code": "car-rent-group",
- "facilities": [
- "abc123"
]
}
]
}
}Reservation widget page
Widget spec for implementing to external pages via iframe or as a direct link. Reservation source is automatically determined from the HTTP referrer.
path Parameters
| channel required | string Unique string id of specified channel. |
| facilityGid required | string Example: abc123 Unique id of specified facility you want to make reservation in. |
query Parameters
| css | string Example: css=https://mydomain.com/assets/mycustom.css Possibility to add custom css and customize the design of our widget to one's needs. The CSS is changed by overriding our classes with one's own. Our classes are not documented, so there is a need to look at the source. |
Responses
HTML content
Wrong GID, facility does not exist or is not active
Staging server.
Production server.