Els mètodes HTTP són fonamentals per a la comunicació entre clients i servidors a través de la web. Aquests mètodes defineixen les accions que es poden realitzar sobre els recursos d'un servidor. En aquesta secció, explorarem els mètodes HTTP més comuns i com s'utilitzen en el context de les API.

1. GET

   • Descripció: S'utilitza per sol·licitar dades d'un recurs específic del servidor.
   • Característiques:
     • No modifica l'estat del recurs.
     • És idempotent, és a dir, fer la mateixa sol·licitud múltiples vegades no canvia el resultat.
   • Exemple:

     GET /api/llibres HTTP/1.1
     Host: exemple.com
     

   • Ús comú: Obtenir informació, com ara llistats de dades o detalls d'un element específic.

2. POST

   • Descripció: S'utilitza per enviar dades al servidor per crear un nou recurs.
   • Característiques:
     • Pot modificar l'estat del servidor.
     • No és idempotent, ja que enviar la mateixa sol·licitud diverses vegades pot crear múltiples recursos.
   • Exemple:

     POST /api/llibres HTTP/1.1
     Host: exemple.com
     Content-Type: application/json
     
     {
       "títol": "Nou Llibre",
       "autor": "Autor Exemple"
     }
     

   • Ús comú: Crear nous registres o enviar dades per a processament.

3. PUT

   • Descripció: S'utilitza per actualitzar un recurs existent o crear-lo si no existeix.
   • Característiques:
     • És idempotent.
     • Requereix enviar l'estat complet del recurs.
   • Exemple:

     PUT /api/llibres/1 HTTP/1.1
     Host: exemple.com
     Content-Type: application/json
     
     {
       "títol": "Llibre Actualitzat",
       "autor": "Autor Exemple"
     }
     

   • Ús comú: Actualitzar informació existent.

4. DELETE

   • Descripció: S'utilitza per eliminar un recurs específic del servidor.
   • Característiques:
     • És idempotent.
   • Exemple:

     DELETE /api/llibres/1 HTTP/1.1
     Host: exemple.com
     

   • Ús comú: Eliminar registres o dades.

5. PATCH

   • Descripció: S'utilitza per aplicar modificacions parcials a un recurs.
   • Característiques:
     • No és idempotent.
     • Només envia els canvis que cal aplicar.
   • Exemple:

     PATCH /api/llibres/1 HTTP/1.1
     Host: exemple.com
     Content-Type: application/json
     
     {
       "títol": "Títol Modificat"
     }
     

   • Ús comú: Actualitzar parcialment un recurs.

Objectiu: Practicar l'ús dels mètodes HTTP mitjançant sol·licituds simulades.

1. Descripció de l'escenari:

   • Tens una API que gestiona una biblioteca de llibres.
   • Practica l'ús dels mètodes GET, POST, PUT, DELETE i PATCH.

2. Tasques:

   • GET: Obteniu la llista de tots els llibres.
   • POST: Afegiu un nou llibre a la biblioteca.
   • PUT: Actualitzeu la informació d'un llibre existent.
   • DELETE: Elimineu un llibre de la biblioteca.
   • PATCH: Modifiqueu només el títol d'un llibre.

3. Solució:

   • GET:

     GET /api/llibres HTTP/1.1
     Host: exemple.com
     

   • POST:

     POST /api/llibres HTTP/1.1
     Host: exemple.com
     Content-Type: application/json
     
     {
       "títol": "Nou Llibre",
       "autor": "Autor Exemple"
     }
     

   • PUT:

     PUT /api/llibres/1 HTTP/1.1
     Host: exemple.com
     Content-Type: application/json
     
     {
       "títol": "Llibre Actualitzat",
       "autor": "Autor Exemple"
     }
     

   • DELETE:

     DELETE /api/llibres/1 HTTP/1.1
     Host: exemple.com
     

   • PATCH:

     PATCH /api/llibres/1 HTTP/1.1
     Host: exemple.com
     Content-Type: application/json
     
     {
       "títol": "Títol Modificat"
     }
     

Els mètodes HTTP són essencials per a la interacció amb les API. Comprendre com i quan utilitzar cada mètode és crucial per desenvolupar aplicacions web eficients i segures. En el següent tema, explorarem com utilitzar Postman per crear i gestionar sol·licituds HTTP de manera efectiva.