Les col·leccions de Postman són una eina poderosa que permet organitzar, gestionar i compartir sol·licituds d'API de manera eficient. En aquesta secció, aprendrem com crear i utilitzar col·leccions per millorar el nostre flux de treball de proves d'API.
Què és una Col·lecció de Postman?
Una col·lecció de Postman és un conjunt de sol·licituds d'API agrupades que poden ser organitzades i executades conjuntament. Les col·leccions permeten:
- Organitzar sol·licituds: Agrupar sol·licituds relacionades per facilitar la gestió.
- Compartir sol·licituds: Facilitar la col·laboració amb altres membres de l'equip.
- Executar sol·licituds seqüencialment: Automatitzar el procés de proves executant múltiples sol·licituds en ordre.
Creació d'una Col·lecció
Pas a Pas
- Obrir Postman: Assegura't que tens Postman obert i que estàs a la vista principal.
- Crear una nova col·lecció:
- Fes clic a la pestanya "Collections" a la barra lateral esquerra.
- Fes clic al botó "New Collection".
- Assigna un nom a la teva col·lecció i, opcionalment, afegeix una descripció.
- Afegir sol·licituds a la col·lecció:
- Crea una nova sol·licitud o selecciona una sol·licitud existent.
- Fes clic al botó "Save" i selecciona la col·lecció on vols guardar la sol·licitud.
Exemple Pràctic
1. Crea una col·lecció anomenada "API de Mostra". 2. Afegeix una sol·licitud GET a `https://api.example.com/users` a la col·lecció. 3. Afegeix una sol·licitud POST a `https://api.example.com/users` amb un cos JSON per crear un nou usuari.
Ús de les Col·leccions
Executar una Col·lecció
- Manualment: Pots executar cada sol·licitud de la col·lecció manualment fent clic a cada una.
- Automàticament amb Runner:
- Fes clic al botó "Runner" a la part superior dreta de la finestra de Postman.
- Selecciona la col·lecció que vols executar.
- Configura les opcions d'execució, com ara el nombre de repeticions o l'ús de variables d'entorn.
- Fes clic a "Run" per executar totes les sol·licituds de la col·lecció seqüencialment.
Compartir una Col·lecció
- Exportar: Pots exportar la col·lecció com un fitxer JSON i compartir-lo amb altres.
- Compartir a l'equip: Si utilitzes Postman Pro o Enterprise, pots compartir col·leccions directament amb el teu equip dins de Postman.
Exercici Pràctic
Objectiu: Crear una col·lecció que inclogui sol·licituds per obtenir, crear i eliminar usuaris d'una API de mostra.
- Crea una col·lecció anomenada "Gestió d'Usuaris".
- Afegeix una sol·licitud GET a
https://api.example.com/users
. - Afegeix una sol·licitud POST a
https://api.example.com/users
amb un cos JSON per crear un usuari. - Afegeix una sol·licitud DELETE a
https://api.example.com/users/{id}
per eliminar un usuari.
Solució:
1. Crea la col·lecció "Gestió d'Usuaris". 2. Afegeix la sol·licitud GET a la col·lecció. 3. Afegeix la sol·licitud POST amb el cos: { "name": "John Doe", "email": "[email protected]" } 4. Afegeix la sol·licitud DELETE amb el paràmetre de ruta `{id}`.
Conclusió
Les col·leccions de Postman són una eina essencial per organitzar i automatitzar les proves d'API. Amb la capacitat de compartir i executar sol·licituds de manera eficient, les col·leccions faciliten la col·laboració i milloren el flux de treball de proves. En el següent tema, explorarem com utilitzar variables d'entorn a Postman per fer les nostres sol·licituds més dinàmiques i flexibles.
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