En aquest tema, explorarem com funcionen les sol·licituds i respostes en el context de les API. Entendre aquests conceptes és fonamental per realitzar proves efectives amb Postman.
Conceptes Clau
Sol·licitud HTTP
Una sol·licitud HTTP és un missatge enviat des del client (per exemple, Postman) al servidor per demanar una acció específica. Les sol·licituds HTTP tenen diversos components:
-
Mètode HTTP: Indica l'acció que es vol realitzar. Els mètodes més comuns són:
GET
: Obtenir dades del servidor.POST
: Enviar dades al servidor.PUT
: Actualitzar dades existents.DELETE
: Eliminar dades.
-
URL (Uniform Resource Locator): L'adreça del recurs al qual es vol accedir.
-
Headers: Informació addicional enviada amb la sol·licitud, com el tipus de contingut (
Content-Type
), l'autenticació (Authorization
), etc. -
Body: Contingut de la sol·licitud, utilitzat principalment amb mètodes com
POST
iPUT
per enviar dades al servidor.
Resposta HTTP
Una resposta HTTP és el missatge que el servidor envia de tornada al client després de processar la sol·licitud. Les respostes HTTP també tenen diversos components:
-
Codi d'Estat: Indica el resultat de la sol·licitud. Alguns codis comuns són:
200 OK
: La sol·licitud s'ha processat correctament.404 Not Found
: El recurs sol·licitat no s'ha trobat.500 Internal Server Error
: Hi ha hagut un error al servidor.
-
Headers: Informació addicional sobre la resposta, com el tipus de contingut (
Content-Type
), la longitud del contingut (Content-Length
), etc. -
Body: Contingut de la resposta, que pot incloure dades sol·licitades, missatges d'error, etc.
Exemple Pràctic
A continuació, veurem un exemple pràctic d'una sol·licitud i resposta HTTP utilitzant Postman.
Sol·licitud GET
- Mètode:
GET
- URL:
https://example.com/api/users/1
- Header:
Authorization: Bearer <token>
Resposta
HTTP/1.1 200 OK Content-Type: application/json Content-Length: 85 { "id": 1, "name": "John Doe", "email": "[email protected]" }
- Codi d'Estat:
200 OK
- Header:
Content-Type: application/json
- Body: Conté les dades de l'usuari sol·licitat.
Exercici Pràctic
Objectiu: Realitzar una sol·licitud GET a una API pública i analitzar la resposta.
- Pas 1: Obre Postman i crea una nova sol·licitud.
- Pas 2: Configura la sol·licitud amb el mètode
GET
i l'URLhttps://jsonplaceholder.typicode.com/posts/1
. - Pas 3: Fes clic a "Send" per enviar la sol·licitud.
- Pas 4: Analitza la resposta que reps. Identifica el codi d'estat, els headers i el body.
Solució
Després d'enviar la sol·licitud, hauríeu de veure una resposta similar a aquesta:
- Codi d'Estat:
200 OK
- Headers: Inclouen
Content-Type: application/json; charset=utf-8
- Body: Conté les dades del post sol·licitat en format JSON.
Conclusió
En aquesta secció, hem après com es construeixen les sol·licituds i respostes HTTP, i com interpretar-les utilitzant Postman. Aquest coneixement és essencial per a qualsevol prova d'API, ja que ens permet comprendre com interactuen els clients i els servidors. En el següent tema, explorarem com utilitzar les col·leccions de Postman per organitzar i gestionar les nostres sol·licituds de manera eficient.
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