Links to guidelines from different companies.
- Structured error messages for HTTP APIs
- Google API Improvement Proposals
- Google JSON Style Guide
- Zalando RESTful API and Event Guidelines
- Hyphen, underscore, or camelCase as word delimiter in URIs
You should use hyphens in a crawlable web application URL. Why? Because the hyphen separates words (so that a search engine can index the individual words), and a hyphen is not a word character. Underscore is a word character, meaning it should be considered part of a word.
- Double-click this: camelCase
- Double-click this: under_score
- Double-click this: hyphen-ated
See how browser only thinks one of those is two words?
camelCase and underscore also require the user to use the shift key, whereas hyphenated does not.