En aquesta secció, aprendràs a crear la teva primera sol·licitud d'API utilitzant Postman. Aquest és un pas fonamental per començar a interactuar amb APIs i entendre com funcionen les sol·licituds i respostes HTTP.
Objectius d'Aprenentatge
- Entendre com configurar una sol·licitud HTTP bàsica a Postman.
- Aprendre a enviar una sol·licitud i interpretar la resposta.
- Familiaritzar-se amb la interfície de Postman per gestionar sol·licituds.
Passos per Crear una Sol·licitud
- Obrir Postman
- Assegura't que tens Postman instal·lat i obert al teu ordinador.
- Si encara no ho has fet, pots descarregar-lo des del lloc web oficial de Postman.
- Crear una Nova Sol·licitud
- A la interfície de Postman, fes clic al botó "New" (Nou) a la part superior esquerra.
- Selecciona "Request" (Sol·licitud) al menú que apareix.
- Configurar la Sol·licitud
- Nom de la Sol·licitud: Assigna un nom a la teva sol·licitud per identificar-la fàcilment.
- Col·lecció: Pots guardar la sol·licitud en una col·lecció existent o crear-ne una de nova per organitzar les teves sol·licituds.
- Seleccionar el Mètode HTTP
- A la barra de sol·licitud, selecciona el mètode HTTP que vols utilitzar. Els mètodes més comuns són:
- GET: Per obtenir dades d'un servidor.
- POST: Per enviar dades a un servidor.
- PUT: Per actualitzar dades en un servidor.
- DELETE: Per eliminar dades d'un servidor.
- Introduir l'URL de l'API
- A la barra d'URL, introdueix l'endpoint de l'API amb la qual vols interactuar. Per exemple, pots utilitzar un endpoint públic com
https://jsonplaceholder.typicode.com/posts
.
- Afegir Paràmetres i Capçaleres (Opcional)
- Paràmetres: Si la teva sol·licitud requereix paràmetres de consulta, pots afegir-los a la secció "Params".
- Capçaleres: Pots afegir capçaleres HTTP a la secció "Headers" si són necessàries per a la teva sol·licitud.
- Enviar la Sol·licitud
- Fes clic al botó "Send" (Enviar) per enviar la sol·licitud.
- Observa la resposta que es mostra a la part inferior de la interfície de Postman.
Interpretar la Resposta
- Codi d'Estat: Indica el resultat de la sol·licitud (per exemple, 200 per èxit, 404 per no trobat).
- Cos de la Resposta: Mostra les dades retornades pel servidor.
- Temps de Resposta: Indica quant de temps ha trigat el servidor a respondre.
Exemple Pràctic
A continuació, es mostra un exemple de com crear una sol·licitud GET a Postman:
- Codi d'Estat Esperat: 200 OK
- Cos de la Resposta Esperat: Un objecte JSON amb les dades del post.
Exercici Pràctic
Objectiu: Crea una sol·licitud GET per obtenir informació d'un usuari.
- Obre Postman i crea una nova sol·licitud.
- Selecciona el mètode GET.
- Introdueix l'URL:
https://jsonplaceholder.typicode.com/users/1
- Envia la sol·licitud i revisa la resposta.
Solució
Després d'enviar la sol·licitud, hauràs de veure una resposta amb el codi d'estat 200 i un cos de resposta que conté informació sobre l'usuari amb ID 1.
Conclusió
Has après a crear i enviar la teva primera sol·licitud d'API amb Postman. Aquest és un pas essencial per començar a treballar amb APIs i entendre com interactuar amb elles. En el següent tema, aprofundirem en la comprensió de les sol·licituds i respostes HTTP.
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