Richardson Maturity Model

Level 0

• Expose SOAP web services in REST style
• Examples
• http://server/getPosts
• http://server/deletePosts
• http://server/doThis

Level 1

• Expose resources with a proper URI
• With improper use of HTTP methods
• Examples
• http://server/accounts POST
• http://server/accounts/10 POST

Level 2

• Expose resources with a proper URI
• With PROPER use of HTTP methods

Level 3

• Expose resources with a proper URI
• With PROPER use of HTTP methods
• HATEOS

Best practices

1. Documentation with Open API
2. Best use of HTTP METHODS
3. Best use of HTTP status codes
4. No secure info in the URI
5. Use plurals. E.g., /users/1
6. Nouns for resources