V3 API

Authentication

Authentication is performed by including an HTTP header

curl -H "key: {apiKey}" https://v3manager.com/{tenant}/booking.api?id={id}

Errors

The API uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a booking failed, etc.).

Dates

Dates are always expected and returned in the tenant local time. The date format is ISO 8601. For example:

2022-08-29T10:00:00

Endpoints

Bookings

Book a resource

Method POST

Argument Type Required Description
type string yes The booking type code or id
start datetime yes The start date of the booking

Example:

curl -H "key: {apiKey}" https://v3manager.com/{tenant}/book.api \
 -d type=60m \
 -d start=2022-08-29T10:00:00

Response:

{
    "minutes":60,
    "price":25,
    "ref":"AZ6H3",
    "start":"2022-08-29T10:00:00+02:00",
    "timeout":null
}