RESTful API Design: Best Practices in API Design with REST

by Matthias Biehl

Self-Explanatory, Intuitive and Predictable The URI needs to be predictable, the parameters need to be self-explanatory and the data objects need to be easy to understand.

REST is not a standard. REST is not a protocol either. REST is an architectural style consisting of architectural constraints and agreements, which are based on HTTP.

We should use guidelines, conventions and standards as much as possible to achieve consistency.