topic What is the recommended POST syntax for Gaia REST API? in API / CLI Discussion

What is the recommended POST syntax for Gaia REST API?

phlrnnr — Fri, 15 Feb 2019 21:39:33 GMT

In sk143612, the syntax for a POST to the Gaia REST API is:

https://<your-server-ip>/gaia_api/<command>

However, the online documentation included once the Gaia API is installed shows the syntax as:

What is the recommended syntax? With the /v1/ or without?

Thanks!

PhoneBoy — Fri, 15 Feb 2019 23:03:20 GMT

I am going to recommend with v1 and here's why: upgrades to the API.

If you use the version number in the API call, you should always get the same behavior, even as the API is updated.

If you don't include the version number, I believe it will always default to the latest version, which may change behavior as the API evolves.