Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Content Negotiation #39
Basics of content negotiation would be, do we offer application/csv, and text/html, as well as applicaiton/json (which is current default).
Advanced would be offering application/vnd.api+json, application/hal+json, or application/vnd.siren+json.
I'm thinking that offering a simple CSV and JSON response for default make sense for newbies. Content negotiation 101. Then we could start loading up some of the more detailed requests, and solving the "return everything" and "return exactly what I want" with introduction of hypermedia type, or even possibly something like application/vnd.hsds+api.
HSDA will support:
Out of the box. Every path except for /complete will support all three--it will only support JSON & XML.
All other projects will support JSON & XML.
My plan was to establish vendor media types, and eventually submit to IANA as projects mature, but my current stance is to hold off: