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
-
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.
-
Instal·lar Postman:
- Executa l'instal·lador descarregat.
- Segueix les instruccions de l'assistent d'instal·lació per completar el procés.
-
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
-
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.
- Familiaritza't amb la interfície d'usuari de Postman. Els elements clau inclouen:
-
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.
-
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ó
-
Què és una Col·lecció?
- Una col·lecció és un conjunt organitzat de sol·licituds que pots agrupar per projecte o funcionalitat.
-
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ó.
-
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.
- Instal·la i inicia Postman.
- Crea un nou entorn anomenat "Desenvolupament" i afegeix una variable
baseUrl
amb el valorhttps://api.example.com
. - Crea una col·lecció anomenada "API de Prova".
- Afegeix una sol·licitud GET a la col·lecció "API de Prova" que apunti a
{{baseUrl}}/status
. - 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.
Curs de Postman i Proves d'API
Mòdul 1: Introducció a les API i Postman
Mòdul 2: Proves Bàsiques d'API amb Postman
- Creació de la Teva Primera Sol·licitud
- Comprensió de la Sol·licitud i la Resposta
- Ús de les Col·leccions de Postman
- Variables d'Entorn a Postman
Mòdul 3: Tècniques Intermèdies de Proves d'API
- Enllaçar Sol·licituds
- Ús de Scripts de Postman
- Proves Basades en Dades amb Postman
- Proves d'APIs RESTful
Mòdul 4: Funcions Avançades de Postman
- Automatització de Proves amb Newman
- Integració Contínua amb Postman
- Servidors Simulats a Postman
- Tècniques Avançades de Scripting
Mòdul 5: Millors Pràctiques de Proves d'API
- Disseny de Casos de Prova Efectius
- Gestió de l'Autenticació
- Gestió d'Errors i Depuració
- Proves de Rendiment amb Postman