Use RFC6570 URI Templates in Hypermedia Responses

[tilgovi]

http://tools.ietf.org/html/rfc6570

[nickstenning]

Sounds like a good plan. As you mention in openannotation/annotator#275, this will break backwards compatibility. I propose the following.

We serve a v2 API in two different ways:

• at /api/v2
• at /api, in response to an appropriate "Accept" header (e.g. application/vnd.annotator.v2+json)

[tilgovi]

Yep
On Oct 30, 2013 9:37 AM, "Nick Stenning" [email protected] wrote:

Sounds like a good plan. As you mention in openannotation/annotator#275openannotation/annotator#275,
this will break backwards compatibility. I propose the following.

We serve a v2 API in two different ways:

• at /api/v2
• at /api, in response to an appropriate "Accept" header (e.g.
  application/vnd.annotator.v2+json)

—
Reply to this email directly or view it on GitHubhttps://github.com//issues/66#issuecomment-27408956
.

[tilgovi]

Just to chime in here, I think we should delay this until we release annotator v2 and do a simultaneous release where we just bump the version and do this without any compat code.

[tilgovi]

I think there are probably few people, if any, beyond Hypothes.is who are using the response to this endpoint to bootstrap their Store plugin.

[nickstenning]

openannotation/annotator@2116119