En aquesta secció, aprendrem com configurar Postman per començar a realitzar proves d'API. Postman és una eina poderosa per interactuar amb APIs i és essencial tenir-la configurada correctament per treure-li el màxim profit.

Instal·lació de Postman

  1. Descarregar Postman:

    • Visita el lloc web oficial de Postman: https://www.postman.com/downloads/.
    • Selecciona la versió adequada per al teu sistema operatiu (Windows, macOS, Linux) i descarrega l'instal·lador.
  2. Instal·lar Postman:

    • Executa l'instal·lador descarregat.
    • Segueix les instruccions de l'assistent d'instal·lació per completar el procés.
  3. Iniciar Postman:

    • Un cop instal·lat, obre Postman.
    • Pots crear un compte o iniciar sessió si ja en tens un. Això et permetrà sincronitzar les teves col·leccions i configuracions entre dispositius.

Configuració Inicial de Postman

  1. Interfície d'Usuari:

    • Familiaritza't amb la interfície d'usuari de Postman. Els elements clau inclouen:
      • Barra de Navegació: Accés a col·leccions, entorns, històric de sol·licituds, etc.
      • Editor de Sol·licituds: On crearàs i enviaràs sol·licituds.
      • Panell de Resposta: Mostra les respostes de les sol·licituds enviades.
  2. Configuració de Preferències:

    • Accedeix a les preferències de Postman a través del menú de configuració (icona d'engranatge).
    • Ajusta les preferències segons les teves necessitats, com ara el tema de l'aplicació, la configuració de xarxa, etc.
  3. Configuració d'Entorns:

    • Els entorns permeten definir variables que poden ser utilitzades en les sol·licituds.
    • Crea un nou entorn des de la pestanya "Manage Environments".
    • Defineix variables com baseUrl, apiKey, etc., que poden variar entre entorns (per exemple, desenvolupament, proves, producció).

Creació d'una Col·lecció

  1. Què és una Col·lecció?

    • Una col·lecció és un conjunt organitzat de sol·licituds que pots agrupar per projecte o funcionalitat.
  2. Crear una Col·lecció:

    • A la barra de navegació, fes clic a "New" i selecciona "Collection".
    • Assigna un nom a la col·lecció i, opcionalment, afegeix una descripció.
  3. Afegir Sol·licituds a la Col·lecció:

    • Crea una nova sol·licitud i guarda-la a la col·lecció creada.
    • Pots organitzar les sol·licituds en carpetes dins de la col·lecció per a una millor gestió.

Exercici Pràctic

Objectiu: Configurar Postman i crear una col·lecció amb una sol·licitud bàsica.

  1. Instal·la i inicia Postman.
  2. Crea un nou entorn anomenat "Desenvolupament" i afegeix una variable baseUrl amb el valor https://api.example.com.
  3. Crea una col·lecció anomenada "API de Prova".
  4. Afegeix una sol·licitud GET a la col·lecció "API de Prova" que apunti a {{baseUrl}}/status.
  5. Envia la sol·licitud i revisa la resposta al panell de resposta.

Solució de l'Exercici

1. Inicia Postman i crea un nou entorn:
   - Nom: Desenvolupament
   - Variable: baseUrl
   - Valor: https://api.example.com

2. Crea una col·lecció:
   - Nom: API de Prova

3. Afegeix una sol·licitud GET:
   - URL: {{baseUrl}}/status
   - Guarda la sol·licitud a la col·lecció "API de Prova".

4. Envia la sol·licitud i revisa la resposta.

Conclusió

Ara que has configurat Postman i creat la teva primera col·lecció, estàs preparat per començar a explorar les capacitats de Postman per a proves d'API. En el següent mòdul, aprendrem a crear i gestionar sol·licituds d'API bàsiques.

© Copyright 2024. Tots els drets reservats