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

  1. Obrir Postman: Assegura't que tens Postman obert i que estàs a la vista principal.
  2. 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ó.
  3. 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.

  1. Crea una col·lecció anomenada "Gestió d'Usuaris".
  2. Afegeix una sol·licitud GET a https://api.example.com/users.
  3. Afegeix una sol·licitud POST a https://api.example.com/users amb un cos JSON per crear un usuari.
  4. 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.

© Copyright 2024. Tots els drets reservats