Multi Island API Announcement to Partners (Updated - January 2024)
Based on feedback from our partners we have adapted our strategy in moving to multi islands, we have found ways to remove any direct impact on our partners. Please read below for updated release strategy and what this means for you.
Cloudbeds is growing quickly, we need to make adaptations to our system to handle this growth. Cloudbeds has decided that we will be implementing a multi island strategy for our platform. What this means is that customers will be distributed among different copies of our platform, this is what we call “islands”. Islands will be regionally specific, US, EU, and APAC and there can be more than one island per region, US1, US2, etc. We have our second island ready and will be adding pilot customers in the coming weeks. We expect to add multiple islands and customers on these islands from Q1 2024 going forward.
With the move to islands, there were some changes in our API we are making to handle customers on the new islands. The first is a move to strings for all of our IDs. In order for us to maintain unique IDs across islands we needed longer IDs than can be supported as 32 bit integers. Much of our API was already formatted as strings, but we have never used an id that was outside the range of an Integer, so this may result in a breakage of your system. No change to the API are required to support your current customers, but as we add new customers we will begin issue ids that are larger ids that will go beyond the 32 bit range. So it is important that you update your systems right away to support these longer ids. We have created a test property with large ids added, you can test your system with this property to ensure it handles the larger ids. Reach out to firstname.lastname@example.org to arrange this test.
To facilitate routing between islands we have introduced a url change and provided a new version a of our API, Cloudbeds API v1.2 The new url is https://api.cloudbeds.com It is not required to move to v1.2 to support customers on multi island, but we will require that you move to new the versions 1.2 by July 1st, 2024. v1.1 will be available on the old url as well as the new url, while v1.2 will only be available on api.cloudbeds.com. Additionally v1.2 will require that you include propertyID in the header of your requests, in X-Property-ID. This change will aid in the routing of requests to the appropriate island.