El Projecte | Sobre nosaltres | Contribuir | Donacions | Llicència

HOME

En aquesta secció, aprendrem com realitzar proves d'APIs públiques utilitzant Postman. Les APIs públiques són aquelles que estan disponibles per a qualsevol usuari a través d'Internet, sovint amb l'objectiu de proporcionar dades o funcionalitats que altres aplicacions poden utilitzar.

Objectius d'Aprenentatge

Comprendre què són les APIs públiques i com accedir-hi.
Aprendre a configurar i enviar sol·licituds a APIs públiques amb Postman.
Analitzar les respostes de les APIs públiques per verificar la seva funcionalitat.
Identificar i gestionar els problemes comuns que poden sorgir durant les proves.

Què són les APIs Públiques?

Les APIs públiques són interfícies de programació d'aplicacions que estan disponibles per a qualsevol desenvolupador o usuari que vulgui accedir-hi. Aquestes APIs solen oferir accés a dades o serveis d'una organització o plataforma.

Característiques de les APIs Públiques:

Accés Obert: Qualsevol pot accedir-hi, sovint amb un registre previ per obtenir una clau d'API.
Documentació Disponible: Normalment, les APIs públiques tenen documentació detallada que explica com utilitzar-les.
Limitacions d'Ús: Poden tenir límits de taxa d'ús per evitar abusos.

Configuració de Postman per a Proves d'APIs Públiques

Pas 1: Obtenir la Clau d'API

Moltes APIs públiques requereixen una clau d'API per autenticar les sol·licituds. Registra't al lloc web de l'API per obtenir la teva clau.

Pas 2: Crear una Nova Sol·licitud a Postman

Obre Postman i crea una nova sol·licitud.
Selecciona el mètode HTTP adequat (GET, POST, etc.) segons la documentació de l'API.
Introdueix l'URL de l'API pública.

Pas 3: Afegir la Clau d'API

Afegeix la clau d'API als encapçalaments de la sol·licitud o com a paràmetre de consulta, segons les instruccions de l'API.

GET https://api.example.com/data
Headers:
  Authorization: Bearer YOUR_API_KEY

Enviament de Sol·licituds i Anàlisi de Respostes

Enviar la Sol·licitud

Fes clic a "Send" a Postman per enviar la sol·licitud a l'API pública.

Analitzar la Resposta

Codi d'Estat HTTP: Verifica el codi d'estat per assegurar-te que la sol·licitud s'ha processat correctament (per exemple, 200 OK).
Cos de la Resposta: Examina el cos de la resposta per assegurar-te que conté les dades esperades.

{
  "status": "success",
  "data": {
    "id": 1,
    "name": "Example Data"
  }
}

Gestió de Problemes Comuns

Errors d'Autenticació

Assegura't que la clau d'API és correcta i que està inclosa a la sol·licitud.

Límits de Taxa

Si reps errors relacionats amb límits de taxa, revisa la documentació de l'API per ajustar la freqüència de les teves sol·licituds.

Respostes Invàlides

Verifica que la sol·licitud està ben formada i que els paràmetres són correctes.

Exercici Pràctic

Objectiu: Realitzar una sol·licitud GET a una API pública i analitzar la resposta.

Tria una API pública de la teva elecció (per exemple, OpenWeatherMap, NASA API).
Obteniu la clau d'API necessària.
Configura una sol·licitud GET a Postman amb l'URL de l'API.
Afegeix la clau d'API als encapçalaments.
Envia la sol·licitud i analitza la resposta.

Solució

Registra't a l'API pública i obtén la clau d'API.
Crea una nova sol·licitud GET a Postman.
Introdueix l'URL de l'API i afegeix la clau d'API als encapçalaments.
Envia la sol·licitud i verifica que el codi d'estat sigui 200 OK.
Examina el cos de la resposta per assegurar-te que conté les dades esperades.

Conclusió

Les proves d'APIs públiques amb Postman són una manera excel·lent de practicar les teves habilitats de prova d'API. A través d'aquest procés, has après a configurar sol·licituds, gestionar claus d'API i analitzar respostes. Aquestes habilitats són fonamentals per a qualsevol desenvolupador o provador d'APIs. En el següent tema, explorarem les proves d'APIs privades, que presenten desafiaments addicionals en termes d'autenticació i seguretat.

Proves d'APIs Públiques