Start with resources
An API should speak the language of the domain rather than mirror database tables. Stable errors and traceable request identifiers are part of the product experience.
Designing an Elegant RESTful API
A practical guide to resource modeling, error semantics and API evolution.