En aquest tema, explorarem com realitzar proves d'APIs RESTful utilitzant Postman. Les APIs RESTful són àmpliament utilitzades per la seva simplicitat i escalabilitat. Aprendrem a provar les operacions CRUD (Crear, Llegir, Actualitzar, Eliminar) i a verificar que les respostes de l'API siguin correctes.

Conceptes Clau

  1. REST (Representational State Transfer):

    • Un estil arquitectònic per dissenyar serveis web.
    • Utilitza mètodes HTTP estàndard com GET, POST, PUT, DELETE.
    • Les dades es representen sovint en format JSON o XML.
  2. Operacions CRUD:

    • Crear (Create): Generalment utilitza el mètode POST.
    • Llegir (Read): Utilitza el mètode GET.
    • Actualitzar (Update): Utilitza els mètodes PUT o PATCH.
    • Eliminar (Delete): Utilitza el mètode DELETE.
  3. Codi d'Estat HTTP:

    • 200 OK: Sol·licitud reeixida.
    • 201 Created: Nou recurs creat.
    • 204 No Content: Sol·licitud reeixida però sense contingut a retornar.
    • 400 Bad Request: Sol·licitud incorrecta.
    • 404 Not Found: Recurs no trobat.
    • 500 Internal Server Error: Error del servidor.

Exemple Pràctic: Proves d'Operacions CRUD

  1. Crear un Nou Recurs

Sol·licitud POST:

POST /api/products
Content-Type: application/json

{
  "name": "Nou Producte",
  "price": 29.99
}

Explicació:

  • Utilitzem el mètode POST per crear un nou producte.
  • El cos de la sol·licitud conté les dades del producte en format JSON.

  1. Llegir un Recurs

Sol·licitud GET:

GET /api/products/1

Explicació:

  • Utilitzem el mètode GET per obtenir informació sobre el producte amb ID 1.
  • Esperem una resposta amb codi d'estat 200 OK i les dades del producte.

  1. Actualitzar un Recurs

Sol·licitud PUT:

PUT /api/products/1
Content-Type: application/json

{
  "name": "Producte Actualitzat",
  "price": 39.99
}

Explicació:

  • Utilitzem el mètode PUT per actualitzar el producte amb ID 1.
  • El cos de la sol·licitud conté les dades actualitzades del producte.

  1. Eliminar un Recurs

Sol·licitud DELETE:

DELETE /api/products/1

Explicació:

  • Utilitzem el mètode DELETE per eliminar el producte amb ID 1.
  • Esperem una resposta amb codi d'estat 204 No Content.

Exercici Pràctic

Objectiu: Realitzar proves d'operacions CRUD sobre una API RESTful fictícia de gestió de productes.

  1. Crear un nou producte i verificar que el codi d'estat sigui 201 Created.
  2. Llegir el producte creat i verificar que les dades retornades siguin correctes.
  3. Actualitzar el producte i verificar que el codi d'estat sigui 200 OK.
  4. Eliminar el producte i verificar que el codi d'estat sigui 204 No Content.

Solució

  1. Crear un nou producte:

    • Sol·licitud POST amb dades del producte.
    • Verificar resposta amb codi 201 Created.
  2. Llegir el producte:

    • Sol·licitud GET per obtenir el producte.
    • Verificar que les dades coincideixin amb les esperades.
  3. Actualitzar el producte:

    • Sol·licitud PUT amb dades actualitzades.
    • Verificar resposta amb codi 200 OK.
  4. Eliminar el producte:

    • Sol·licitud DELETE per eliminar el producte.
    • Verificar resposta amb codi 204 No Content.

Conclusió

En aquesta secció, hem après a realitzar proves d'operacions CRUD en APIs RESTful utilitzant Postman. Hem explorat com enviar sol·licituds HTTP i verificar les respostes per assegurar-nos que l'API funcioni correctament. Aquestes habilitats són fonamentals per a qualsevol desenvolupador o tester que treballi amb APIs. En el següent mòdul, explorarem funcions avançades de Postman per automatitzar i integrar proves en el flux de treball de desenvolupament.

© Copyright 2024. Tots els drets reservats