Marketplace for Integration Partners: Difference between revisions

Jump to navigation Jump to search
← Older editNewer edit →
No edit summary
No edit summary
Line 1: Line 1:
[[Category:API_V2]]
[[Category:API_V2]]
<div class="heading">Organizations and the Marketplace</div>
<div class="heading">Organisations and the Marketplace</div>


  This page is for external organizations looking to join the Beds24 marketplace
  This page is for external organisations looking to join the Beds24 marketplace


= Capabilities =
= Capabilities =


Beds24 offers a marketplace for external organizations to easily connect with Beds24 users to provide services for them.
Beds24 offers a marketplace for external organisations to easily connect with Beds24 users to provide services for them.
Once a Beds24 user enables a connection to an organization, the organization can access the users Beds24 account by API function to perform their services.
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
The available API functions are the same as the Beds24 API V2 functions https://api.beds24.com/v2


= Getting Started =
= Getting Started =


Contact Beds24 to establish a marketplace entry for your organization.
Contact Beds24 to establish a marketplace entry for your organisation.
Organizations are only accepted at the discretion of Beds24. If your organisation is accepted you will be assigned an organization token and an access token.
Organisations are only accepted at the discretion of Beds24. If your organisation is accepted you will be assigned an organisation token and an access token.


= Authentication =
= Authentication =


Organizations will be whitelisted by function and scope and only able to access their whitelisted functions and scopes.
Organisations will be whitelisted by function and scope and only able to access their whitelisted functions and scopes.


When calling an API function the organization must include the organization header token with every call.
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 organization.  
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 organization and only these enabled room types will be visible.
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.
When calling an API function to access property level data, the property ID must be included with the access token.
Line 32: Line 32:
= Connecting with Beds24 users =
= Connecting with Beds24 users =


Your organization will appear in our Apps and integrations marketplace menu.
Your organisation will appear in our Apps and integrations marketplace menu.
A beds24 user can find your organization there and enable the room types they would like to make available to your organization.
A beds24 user can find your organisation there 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.
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 organization.
The special function GET /organizations/users can be called to see all users who have enabled the connection to your organisation.


= FAQ =
= FAQ =
Retrieved from "https://wiki.beds24.com/index.php/Marketplace_for_Integration_Partners"