REST

Actions

Verbe HTTP	Action
GET	Accéder à une ressource en lecture seule. (Read)
POST	Utilisé pour envoyer une nouvelle ressource (Create)
PUT	Utilisé pour mettre à jour une ressource (Update)
DELETE	Utilisé pour supprimer une ressource (Delete)

Create
- POST - http://localhost/api/books
- Si succès, retourne HTTP 201 Created
Read
- GET - http://localhost/api/books ou http://localhost/api/books/5
- Si succès, retourne HTTP 200 OK
Update
- PUT - http://localhost/api/books/5
- Si succès, retourne HTTP 204 No Content
Delete
- DELETE - http://localhost/api/books/5
- Si succès, retourne HTTP 204 No Content

Les autres actions pourraient être décrites par

GET /api/v1/books/search

Mais comme on veut qu'un URL désigne une ressource, on va plutôt cacher l'action derrière le signe ?:

GET /api/v1/books?action=search

Pour la pagination, il est recommandé d'utiliser limit et offset ¹⁾.

¹⁾