318
edits
Changes
Jump to navigation
Jump to search
Unused refresh tokens Tokens expire after 30 days24 hours.
==Where are scopes set?==For example, with the following a booking cannot check-in on 2024-01-03 because that date is unavailable. However, because the previous date 2024-01-04 is available, it means 2024-01-03 is available for check-out. "availability": {Scopes are set when you create an invite code. "2024-01-01": true, "2024-01-02": true, "2024-01-03": false }
Scopes cannot be changed later, you must create ==What is the maximum amount of data I can send in a new invite code with the scopes you want and exchange it for POST request?==The API has a new tokenlimit of approximately 1MB per POST payload.
==How do I get In addition, there is a token/refresh token?==Create an invite code under Settings -> Apps & Integrations -> APIlimit of 10000 top level JSON array item per POST request.
Exchange this invite code ==Where can I see the possible values for a refresh token and token using the POST booking's apiSourceId (API Source ID)== [[/authentication/setup endpointAPI_V2.0_apisourceids | apiSourceId values can be found here.]]
If you wish to access properties that are not in your account you must tick the "Allow linked properties" checkbox when selecting the scopes for the token.
Note: Properties must be linked under Account Management > Manage Account > Manage Property. Other methods of linking properties are not supported in API V2.
== Subcategory scopes ==
A room can have up to 16 prices.
In the control panel, these can be set under Prices -> Daily Price SetupRules.
In the API these can be accessed through GET and POST /inventory/calendar
}
= Technical details Webhooks === Booking webhooks ==To access booking webhooks for API V2 please contact support. They can then be enabled under Settings > Properties > Access > Booking webhooks.== Other webhooks ==Information about other webhooks (including non API V2 webhooks) can be found here [https://wiki.beds24.com/index.php/Category:Webhooks Webhooks] = Best Practices === Token Management ==Tokens last 24 hours. This means that you do not need to retrieve a new token for each request. Getting a new token costs credits so it is best to use an existing one when possible. == Retrieving information at high frequencies ==Tokens will If you need to get data such as new messages or bookings when they come in you do not need to perform frequent GET requests. Instead, you can use webhooks to be between 152 and 172 characters longnotified as soon as a new message/booking etc arrives. == Sending information at high frequencies ==If you need to send large amounts of information such as messages at high frequencies it is best to send them grouped in bulk POST requests instead of sending one request per message. For example, you could send one POST request every 30 seconds containing all messages sent in the past 30 seconds. == Sending or getting information in one call ==If you need to retrieve information about multiple different things, such as information about several properties, you can retrieve that in one call by specifying multiple IDs in the one request instead of performing one GET request per property. The same principle applies when POSTing information, for example, you can create or update multiple properties in one call.
= Examples =
The API V2 changelog is [[API_V2.0_changelog|available here]].
= FAQ===How do I access API V2?==Create an invite code under {{#fas:cog}} (SETTINGS) Apps & Integrations > API. Exchange this invite code for a refresh token and token using the POST /authentication/setup endpoint. Include the token in your requests to authenticate them. You can try this out using our interactive UI here [https://beds24.com/api/v2 beds24.com/api/v2]. ==What are scopes?==Scopes limit what your token can do. For example, the read/bookings scope allows your token to retrieve bookings via the API, but if your token does not have the write/bookings scope then it cannot be used to create or modify bookings. ==Where are scopes set?==Scopes are set when you create an invite code. Scopes cannot be changed later, you must create a new invite code with the scopes you want and exchange it for a new token.
==How long do invite codes/tokens last?==
Invite codes expire after 15 minutes.
Refresh tokens last forever so long as they are being used. Unused refresh tokens expire after 30 days.
==How big are tokens?==Tokens expire after 24 hourswill be between 152 and 172 characters long.
==What is the API credit limit?==
Each API request has a cost, this cost is calculated dynamically and depends on how complex the request is.
If you go over this limit you will not be able to make additional API calls until the 5 minute period is over.
==Where can I see my API credit limit?==
Information about your credit limit is included in the following API response headers:
*x-five-min-limit-remaining - the number of credits you have left for this 5 minute period.
*x-five-min-limit-resets-in - the number of seconds until the current period resets.
*x-request-cost - the number of credits this request cost.
==Is the API limited per token or per account?==
This means that tokens under the same account share the same credit limit.
==How do I make a new booking/property/room /booking etc?==
Simply do not include an id in your POST request.
Examples for how to do this can be found here:
[https://beds24.com/api/v2/#/Properties/post_properties Properties/Rooms]
[https://beds24.com/api/v2/#/Bookings/post_bookings Bookings]
==Where can I see or set price rules?==
Price rules can be found under /properties.
To retrieve them you must set the includePriceRules parameter to true.
==Where can I see or set offers?==
Offer setup rules can be found under /properties.
To retrieve them you must set the includeOffers parameter to true.
You can retrieve offers (i.e. calculated prices for specific dates) through the /inventory/rooms/offers endpoint.
==How can I see or set prices, min stay, availability etc for specific dates like in the UI calendar?==
These per date values can be read and set through the /inventory/rooms/calendar endpoint.
==Where can I see examples for how to use the API?==
Examples can be found here [https://beds24.com/api/v2 beds24.com/api/v2].
==Can I use API V2 to send pictures or webhooks?==
Currently no, however these features are coming soon.
==What are scopesHow can I see if a date is available for check-in/out?==Scopes limit what your token can doThe GET /inventory/rooms/availability returns information about if dates are available or not. For exampleIf a date is false, the read/bookings scope allows your token to retrieve bookings via the APIit means it is not available for check-in. However, but if your token does not have the write/bookings scope then previous date is available, it cannot be used to create or modify bookingsmeans the date is available for check-out.
