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:

  1. 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.
  2. URL (Uniform Resource Locator): L'adreça del recurs al qual es vol accedir.

  3. Headers: Informació addicional enviada amb la sol·licitud, com el tipus de contingut (Content-Type), l'autenticació (Authorization), etc.

  4. Body: Contingut de la sol·licitud, utilitzat principalment amb mètodes com POST i PUT 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:

  1. 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.
  2. Headers: Informació addicional sobre la resposta, com el tipus de contingut (Content-Type), la longitud del contingut (Content-Length), etc.

  3. 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

GET /api/users/1 HTTP/1.1
Host: example.com
Authorization: Bearer <token>
  • 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.

  1. Pas 1: Obre Postman i crea una nova sol·licitud.
  2. Pas 2: Configura la sol·licitud amb el mètode GET i l'URL https://jsonplaceholder.typicode.com/posts/1.
  3. Pas 3: Fes clic a "Send" per enviar la sol·licitud.
  4. 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.

© Copyright 2024. Tots els drets reservats