REST Richardson Maturity Model
Level | Name | Description |
---|---|---|
0 | The swamp of POX | Use HTTP as a transport system for remote interactions, but without using any of the mechanisms of the web |
1 | Resources | Make requests to a Resource |
2 | HTTP Verbs | Use HTTP Verbs |
3 | Hypermedia Controls | Use HATEOAS (Hypertext As The Engine Of Application State). It addresses the question of how to get from a collection of resources to a single resource |
REST API Naming Convention
Resource Type | Description | Example |
---|---|---|
Collection | The collection resource is a set of singular resources | /customers |
Document | The document is a singular resource e.g. A customer | /customers/{id} |
Store | The Store resource is a client managed resource | /users/{id}/playlists |
Controller | The Controller resource models a procedural concept | /customers/{id}/basket/checkout |