API versioning

[xrmx]

I think the API should be versioned so that people that write clients do know exactly what is available in case of API changes on later releases.

[unbit]

I think adding an header in the response with the api version could be a good solution:

X-uwsgi.it-Api-Version: 1

[xrmx]

@unbit the issue is on the request side not on the response, the client should be able to do a request and know in advance the format, content, etc... of what is returned. So on the request side one should be able to ask for a specific version of the api

[unbit]

ok, the same thing applies, it can add a request header specifying the version it expects

[xrmx]

Sure, but wouldn't adding it to the url be easier to handle on your side?