Différences

Ci-dessous, les différences entre deux révisions de la page.

--- web:rest [2014/02/12 02:26] – modification externe 127.0.0.1
+++ web:rest [2022/04/10 22:20] (Version actuelle) – [Sources] sgariepy
@@ Ligne 1: / Ligne 1: @@
 ====== REST ======
-  * http://rest.elkstein.org/2008/02/what-is-rest.html
+====== 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)  |
+===== REST-ful CRUD =====
+  * 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
+===== Actions plus complexes =====
+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
+===== Pagination =====
+Pour la pagination, il est recommandé d'utiliser **limit** et **offset** ((https://blog.apigee.com/detail/restful_api_design_can_your_api_give_developers_just_the_information)).
+===== Sources =====
+  * [[http://rest.elkstein.org/2008/02/what-is-rest.html|Learn REST: A Tutorial]]