18F / api-standards

API Standards for 18F
Other
486 stars 54 forks source link

Remove recommendation to use a file extension to indicate format #6

Closed konklone closed 10 years ago

konklone commented 10 years ago

I suggest we remove all use of the file extension (.json) to indicate the format of an API endpoint. This was fashionable for some time in the late 2000's -- especially for APIs that support multiple output formats -- but mime types in HTTP headers handle this far better. Plus, they communicate more information, like UTF-8 encoding.

mlissner commented 10 years ago

+1

delfuego commented 10 years ago

Didn't commit db3a2cb0172f7fbfb095c64e845183f0467a7673 already do this?

konklone commented 10 years ago

Good catch!