By ryanuber
On various occasions, I’ve noticed the data structures returned by the API (both v1 and v2) change in a backwards-incompatible way without notice. For example:
https://developers.digitalocean.com/changelog/api-v2/numbers/
The above change breaks existing clients that care about the data type returned. It also seems that the “regions” array has changed from []string to []int, and “region_slugs” now contains the string values for the regions.
It would be great if there was a stronger compatibility promise for existing API endpoints. Currently, even pinning to a specific API version does not guarantee client stability, and makes using DO with various open source tooling which expects certain things from the API responses unpredictable and frustrating.
This textbox defaults to using Markdown to format your answer.
You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!
This question was answered by @brooke:
Hey Ryan,
Sorry you’ve had some frustrations in this area. Right now our V2 API is still in BETA and changes such as the above are still happening as we want to make sure to get it right! We advertise this on the top of our developers page (https://developers.digitalocean.com/), but I apologize if it was not obvious. We have not purposely made changes to V1 and it has been stable for awhile. Please let me know if you found a change that occurred in the V1 API and I will look into it. V2 is coming pretty close to stable and the beta tag should be removed in the near future.
If you have any other questions/problems please feel free to reach out to me at brooke(at)digitalocean.com.
- Brooke McKim, Product Manager
Become a contributor for community
Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.
DigitalOcean Documentation
Full documentation for every DigitalOcean product.
Resources for startups and SMBs
The Wave has everything you need to know about building a business, from raising funding to marketing your product.
The developer cloud
Scale up as you grow — whether you're running one virtual machine or ten thousand.
Get started for free
Sign up and get $200 in credit for your first 60 days with DigitalOcean.*
*This promotional offer applies to new accounts only.