DO Ideas 2

Version your api

Currently all api end points are one and the same, https://api.digitalocean.com/.

When you awesome poeple are going to implement the "expose a really restful api" (http://digitalocean.uservoice.com/forums/136585-digital-ocean/suggestions/3604966-expose-a-really-restful-api ) feature, a lot of api depended apps are going to break.

This is ok. But after this change it should be really clear what is the api. It should be possible to make big changes without affecting everyone directly and breaking there stuff.

So I would say. Start version, make the urls something like https://api.digitalocean.com/v1 https://api.digitalocean.com/v2

This change will make sure your api is dependable in the future.

  • Levi Voorintholt
  • Sep 11 2018
  • Shipped
  • Attach files
  • Moisey Uretsky commented
    September 11, 2018 18:37

    The existing API will be available at / and also /v1 and the new api will be at /v2

    Thanks