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

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

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

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

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

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

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

  1. 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:

GET https://jsonplaceholder.typicode.com/posts/1
  • 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.

  1. Obre Postman i crea una nova sol·licitud.
  2. Selecciona el mètode GET.
  3. Introdueix l'URL: https://jsonplaceholder.typicode.com/users/1
  4. 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.

© Copyright 2024. Tots els drets reservats