Difference between revisions of "Category:API"

This page lists the available APIs and gives general information on how to use them. 

1 Use of the API

The API functions are available at https://api.beds24.com

To use the API you need to allow API ACCES. Go to SETTINGS -> ACCOUNT -> ACCOUNT ACCESS and allow API access. The API is available at https://api.beds24.com.

• The XML functions can be accessed with your Beds24 username and password.
• The JSON functions can be created with a API and prop key which you set yourself in the Beds24 control panel {#fas:cog}} (SETTINGS)ACCOUNT and (SETTINGS) PROPERTIES > ACCESS

The default limit is 60 API calls per 5 minutes for an account.

You should design your interface to eliminate unnecessary calls.

If you put a delay of 5 seconds between calls you should have no problems.

2 Capabilities

2.1 getBookings

• getBookings will return the real time information about the bookings which are in the Beds24 system.
• You can specify a date range. If you do not, the default is to return from now for 1 year.

2.2 setBookings

• You can import existing bookings up to 2 years back (json)/10 years back (.csv).

2.3 getRates/putRates

You can download rates apply changes and import the changed rates (.csv).

Uploading changes for linked rates is not possible.

2.4 json/setRoomDates

• sets daily prices and inventory and min stay

The values will be sent to all channels which are activated for these values in the control panel.

2.5 getInvoicesCSV

• gets invoice items as a .csv file

2.6 getProperty

• access property setup data

2.7 setProperty

• manage property setup data

2.8 getPropertyContent

• access property descriptive content

2.9 setPropertyContent

• manage descriptive content and pictures

For pictures you can set the URL to external pictures and you can map these to properties and rooms.

You cannot upload to our picture hosting via API, you must use your own hosting.

Use JSON getPropertyContent to see the JSON data structure required to be sent to setPropertyContent.

3 API FAQ

3.1 Where can I find the API documentation?

The documentation can be found directly in the API.

3.2 What do I need to do to receive credit card details though the API?

Your systems must be PCI DSS compliant to receive credit card data. Please contact via support ticket for further information.

3.3 Can I delete bookings though the API?

You can cancel bookings though the API but not delete them.