6. Test. Postman i Swagger

Apèndix 1: Postman.

Aquest és un programari gratuït i, a través de Postman, podem fer sol·licituds:

• GET, a una ruta, indicant els paràmetres en totes les seves possibilitats, en la Query de la ruta, com a identificadors en la ruta.
• POST i PUT, permetent d'una manera molt còmoda editar els objectes JSON en el cos (Body) de la sol·licitud.
• DELETE, per realitzar eliminacions.

Vegem com podem treballar amb les consultes a la nostra API acabada de crear. El primer pas a fer és crear un espai de treball o Workspace, on afegirem les nostres sol·licituds.

{width=95%}

Després, podríem començar a crear http_request:

{width=95%}

podríem canviar el tipus de sol·licitud en el selector de l'esquerra:

{width=45%}

podríem establir paràmetres afegint ?name=value en la sol·licitud.

{width=95%}

I podem establir valors de variables en el camí simplement afegint-los a la sol·licitud (com a text en el camí). Recorda que això correspon amb PathVariable.

{width=95%}

Si volem enviar dades, en forma d'objecte JSON, com fan els formularis, hem de configurar dins del cos com a dades raw com a json en una sol·licitud POST o PUT:

{width=95%} {width=95%}

Finalment, aquí tens una sol·licitud DELETE:

{width=95%}

Apèndix 2: Swagger

En aquesta pàgina https://www.baeldung.com/spring-rest-openapi-documentation pots trobar com afegir a la nostra pròpia API un generador de peticions de manera simple.