0% encontró este documento útil (0 votos)
64 vistas9 páginas

2.1. Guía Postman y Consumo de API

Cargado por

wblandon05
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como DOCX, PDF, TXT o lee en línea desde Scribd
0% encontró este documento útil (0 votos)
64 vistas9 páginas

2.1. Guía Postman y Consumo de API

Cargado por

wblandon05
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como DOCX, PDF, TXT o lee en línea desde Scribd
Está en la página 1/ 9

ÁREA DEL CONOCIMIENTO DE CIENCIAS BÁSICAS Y TECNOLÓGICAS

DEPARTAMENTO DE COMPUTACIÓN
Ingeniería en Sistemas de Información

Componente: Programación Web I

Año Académico: 2024 Grupo: SI2V Semestre: II

Guía de uso de Postman y Ejemplos de Peticiones en una


API REST

1. Instalación de Postman

Postman es una herramienta potente y fácil de usar para probar y desarrollar APIs. Sigue estos
pasos para instalarlo en tu sistema.

1.1 Descargar Postman

1. Visita el sitio web oficial de Postman:

o Postman Download

2. Selecciona tu plataforma: Elige la versión adecuada para tu sistema operativo


(Windows, macOS, Linux).

3. Descarga e instala:

o En Windows: Ejecuta el instalador .exe.

o En macOS: Abre el archivo .dmg y arrastra Postman a la carpeta de aplicaciones.

pág. 1
o En Linux: Sigue las instrucciones específicas para tu distribución.

1.2 Configuración Inicial

1. Iniciar sesión: Puedes crear una cuenta gratuita en Postman o usar tu cuenta de Google
para iniciar sesión.

2. Configuración de espacio de trabajo: Postman te pedirá que configures tu espacio de


trabajo. Puedes crear uno nuevo o unirte a uno existente.

pág. 2
2. Uso Básico de Postman

Postman te permite interactuar con APIs mediante peticiones HTTP. A continuación, te explico
cómo realizar una petición básica.

2.1 Realizar una Petición GET

1. Abrir Postman.

2. Seleccionar el tipo de petición: En la parte superior de la pantalla, selecciona GET en el


menú desplegable.

3. Ingresar la URL: En el campo de URL, ingresa la dirección de la API que deseas


consultar, por ejemplo:

https://jsonplaceholder.typicode.com/posts

4. Enviar la petición: Haz clic en el botón Send.

pág. 3
2.2 Visualizar la Respuesta

1. Respuesta del servidor: En la parte inferior, verás la respuesta del servidor, que incluye:

o Status: Código de estado HTTP (por ejemplo, 200 OK).

o Headers: Metadatos sobre la respuesta.

o Body: El cuerpo de la respuesta, que generalmente está en formato JSON o XML.

3. Definición y Ejemplos de Peticiones en una API REST

Una API REST (Representational State Transfer) permite la comunicación entre sistemas usando
peticiones HTTP. Los métodos HTTP más comunes son:

3.1 GET

 Definición: Recupera datos del servidor.

 Ejemplo: Obtener una lista de publicaciones de un blog.

http

GET /posts HTTP/1.1

Host: jsonplaceholder.typicode.com

 Respuesta:

json

"userId": 1,

"id": 1,

"title": "Post Title",


pág. 4
"body": "Post content..."

3.2 POST

 Definición: Envía datos al servidor para crear un nuevo recurso.

 Ejemplo: Crear una nueva publicación.

http

POST /posts HTTP/1.1

Host: jsonplaceholder.typicode.com

Content-Type: application/json

"title": "New Post",

"body": "This is the content of the new post",

"userId": 1

 Respuesta:

json

"id": 101,

"title": "New Post",

"body": "This is the content of the new post",

"userId": 1

pág. 5
3.3 PUT

 Definición: Actualiza un recurso existente.

 Ejemplo: Actualizar una publicación existente.

http

PUT /posts/1 HTTP/1.1

Host: jsonplaceholder.typicode.com

Content-Type: application/json

"id": 1,

"title": "Updated Title",

"body": "Updated content...",

"userId": 1

 Respuesta:

json

pág. 6
"id": 1,

"title": "Updated Title",

"body": "Updated content...",

"userId": 1

3.4 DELETE

 Definición: Elimina un recurso del servidor.

 Ejemplo: Eliminar una publicación.

http

DELETE /posts/1 HTTP/1.1

Host: jsonplaceholder.typicode.com

 Respuesta:

json

{}

pág. 7
4. Proceso de Solicitud y Respuesta en una API REST

El ciclo de vida de una solicitud y respuesta en una API REST generalmente sigue estos pasos:

4.1 Cliente Realiza una Solicitud

1. Inicia la solicitud: Un cliente (por ejemplo, Postman, un navegador, o una aplicación


móvil) envía una solicitud HTTP a un servidor.

2. Componentes de la solicitud:

o Método HTTP: Indica la acción a realizar (GET, POST, PUT, DELETE).

o URL: La dirección del recurso en el servidor.

o Headers: Información adicional sobre la solicitud (como Authorization o Content-


Type).

o Body (opcional): Datos que se envían con la solicitud (usualmente en POST o


PUT).

4.2 Servidor Procesa la Solicitud

1. Interpretación de la solicitud: El servidor recibe la solicitud y determina cómo procesarla


según el método HTTP y la URL.

2. Interacción con la base de datos: El servidor puede interactuar con una base de datos
para recuperar, actualizar, o eliminar datos.

3. Generación de la respuesta: El servidor prepara una respuesta que puede incluir datos
(por ejemplo, en JSON), un código de estado HTTP, y headers.

4.3 Cliente Recibe la Respuesta


pág. 8
1. Respuesta del servidor: El cliente recibe la respuesta del servidor.

o Status code: Un código numérico que indica el resultado de la solicitud (por


ejemplo, 200 OK, 404 Not Found, 500 Internal Server Error).

o Headers: Información adicional sobre la respuesta.

o Body: Los datos devueltos por el servidor (si corresponde).

2. Procesamiento de la respuesta: El cliente procesa la respuesta para mostrar los datos


al usuario, o tomar decisiones basadas en el resultado de la solicitud.

Conclusión

Esta guía cubre desde la instalación de Postman hasta el uso de peticiones en una API REST, y
explica el proceso completo de solicitud y respuesta. Esta información te ayudará a trabajar
eficazmente con APIs REST, tanto en pruebas como en desarrollo.

pág. 9

También podría gustarte