undefined | Better HN

0 pointsnikcub15y ago0 comments

if you don't want to use content negotiation, then stuff it into query parameters - that is what most API's do (and most that support full content negotiation do anyway)

eg.?v=1&format=xml

but interesting to note is that why is encoding easy to do as part of content negotiation, yet everything else is hard? you never see ?e=UTF-8 or &c=gzip

0 comments

4 comments · 2 top-level

wahnfrieden15y ago· 2 in thread

I'm all in favor of supporting fallbacks for more limited clients. But query params are not a great idea since they can prevent caching from happening.

kevinstubbs15y ago

Add a random number to the end as a param to force no-caching.

wahnfrieden15y ago

My point was that it's not a good thing for requests for cacheable content, that might not be cached since you used a query param to access it. Some caches ignore requests with query params since "queries" are often not static.

pzb15y ago

Many APIs simply specify that the encoding is constant (always UTF-8) so this is not an issue. And many HTTP libraries simply handle the content encoding transparently.

The challenge is some HTTP library APIs commonly used for developing clients offer the following interface: - GET $URL

If you are lucky, then it might also support POST and offer a second parameter for the request body. If are really lucky, there is a way to specify arbitrary methods, but this is fairly rare.

j / k navigate · click thread line to collapse