[openstreetmap/openstreetmap-website] Capabilities call and versioning (#2162)

Bryan Housel notifications at github.com
Thu Feb 28 15:59:52 UTC 2019


> Does anything (e.g. editors) actually use the current version information anyway? Do requests for capabilities generally use the versioned or unversioned calls?

iD currently calls `api/capabilities` (unversioned) but we should change this.

It makes more sense to me to just drop the unversioned endpoint and have separate resources for:
* `api/0.6/capabilities`
* `api/0.7/capabilities`

> Should we instead have an api/versions call that just indicates supported versions, and clients can then call api/X/capabilities for the one they want to use? 

seems fine 👍 

> Should we remove the version information from api/X/capabilities since it's not really a capability of that version of the API?

I agree it can be removed, I never even noticed it was there..



-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/openstreetmap/openstreetmap-website/issues/2162#issuecomment-468327922
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstreetmap.org/pipermail/rails-dev/attachments/20190228/eb10160a/attachment.html>


More information about the rails-dev mailing list