Marketplace for Integration Partners: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
m Ricarda moved page Organizations and the Marketplace to Marketplace for Integration Partners |
||
| (26 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
[[Category:API_V2]] | [[Category:API_V2]] | ||
<div class="heading"> Beds24 Marketplace: Organisations / Integration Partners</div> | |||
This page is dedicated to external organisations, service providers and potential integration partners interested in joining the Beds24 marketplace. | |||
The marketplace offers an overview that allows both existing and future customers to discover compatible, integrated partner solutions and easily get in touch. This enables customers to find complementary products that suit their business needs and seamlessly connect solutions into a cohesive, efficient system. | |||
Integration partners will be showcased on Beds24's company website as well as within the control panel, the user interface for Beds24 customers. | |||
Partners interested in establishing a marketplace partnership are encouraged to submit an inquiry by clicking the [https://beds24.com/marketplace.html "Become a partner"] button, which leads to a dedicated form. | |||
= Capabilities = | = Capabilities = | ||
As part of the Beds24 marketplace partnership, services from external organisations offering complementary products for Beds24 customers are showcased within the customers' account and can be easily activated for seamless integration. | |||
Once a Beds24 user enables a connection to an organisation, the organisation can access the users Beds24 account by API function to perform their services. | |||
The available API functions are the same as the Beds24 API V2 functions: https://api.beds24.com/v2 | |||
= Getting Started = | |||
* Apply for a marketplace partnership (Organisations are only accepted at the discretion of Beds24): [https://beds24.com/marketplace.html "Beds24 Marketplace"] | |||
* Once Beds24 confirms your application and you have signed the agreement, you should proceed by signing up for a Beds24 account ([https://www.beds24.com/join.html Join Beds24]) and creating a ticket to request resetting your account to a partner account. | |||
* Create a ticket requesting Beds24 to set up a marketplace entry for your organisation. | |||
* finally, submit a ticket to obtain your organization token and access token for integration purposes. | |||
= Authentication = | |||
Organisations will be whitelisted by function and scope and only able to access their whitelisted functions and scopes. | |||
When calling an API function the organisation must include the organisation header token with every call. | |||
The access token grants access to all Beds24 accounts which have enabled the organisation. | |||
The Beds24 account can specify which of their room types are available to the organisation and only these enabled room types will be visible. | |||
When calling an API function to access property level data, the property ID must be included with the access token. | |||
The format is to use a trailing colon, then a lower case p and then the property ID all with no spaces. | |||
For example an access token to access property ID 12345 could look like this: | |||
abcdefghijklmnopqustuvwxyz:p12345 | |||
= Connecting with Beds24 users = | |||
Your organisation will appear in our marketplace menu in the account of each customer. | |||
A beds24 user can find your organisation there, activate it and enable the room types they would like to make available to your organisation. | |||
These room types will then be available for your API calls. | |||
The special function GET/organizations/users can be called to see all users who have enabled the connection to your organisation. | |||
= FAQ = | = FAQ = | ||