Tried to keep list concise as possible. Following points are actual specs, de facto conventions or good pratices.
- Use nouns, avoid verbs (
/getAccount/123 => /accounts/123
) - Plural form
- Base url:
https://api.example.com
(prefered overhttps://example.com/api/
) - Versioning:
https://api.example.com/v2/
(alternative:Accepts: application/json;application&v=2
) - camelCase (most APIs are JSON based, JSON is JavaScript, Underscores are not JS convention)
- Timestamps (
2004-02-12T15:19:21+00:00
- ISO8061)