Tema 4 · Peticiones GET

Peticiones GET y Parámetros de Consulta (Query Params)

Aprende a estructurar peticiones GET en Postman, utilizar la pestaña Params para filtros, ordenamiento y paginación, y dominar las variables de ruta (:id).

Anatomía de la Interfaz: Pestañas de Petición, Parámetros y Respuesta Peticiones POST, PUT y PATCH con Cuerpos JSON (Raw Body)

¿Qué es una Petición GET y Cómo se Estructura?

El método HTTP GET es el verbo más utilizado de la web. Se utiliza exclusivamente para consultar y recuperar información de un servidor sin alterar el estado de la base de datos (operación idempotente y segura).

Por estándar HTTP, las peticiones GET no deben enviar cuerpo (Body). Si necesitas filtrar, buscar u ordenar los resultados, debes utilizar Query Parameters (Parámetros de Consulta) en la URL.

Uso de la Pestaña "Params" en Postman

En lugar de escribir a mano una URL kilométrica como:
https://api.kilopolis.com/v1/cursos?categoria=backend&orden=recientes&pagina=2&limite=15

Postman ofrece una cuadrícula visual en la pestaña Params:

  1. Escribe la URL base en la barra: https://api.kilopolis.com/v1/cursos.
  2. En la tabla inferior escribe las claves y valores:
    • Key: categoria | Value: backend
    • Key: orden | Value: recientes
    • Key: pagina | Value: 2
    • Key: limite | Value: 15
  3. A medida que escribes, Postman actualiza la URL en tiempo real añadiendo el signo ? y los separadores &.
  4. Casillas de verificación: Puedes desmarcar temporalmente cualquier parámetro (por ejemplo para probar la búsqueda sin paginación) con un solo clic sin tener que borrar el texto.
  5. URL Encoding Automático: Si escribes espacios o caracteres especiales (ej. buscar: "diseño web"), Postman los codifica automáticamente a dise%C3%B1o%20web.

Diferencia entre Query Params y Path Variables (:id)

Tipo Sintaxis en Postman Propósito REST Ejemplo
Path Variable (Variable de Ruta) Dos puntos antes del nombre (:id) Identifica un recurso específico y concreto dentro de una colección. /api/usuarios/:id (donde :id vale 42)
Query Param (Parámetro de Consulta) Signo de interrogación (?clave=valor) Modifica, filtra o pagina el conjunto de resultados devuelto. /api/usuarios?activo=true&rol=admin

⚡ Petición GET con Múltiples Filtros de Paginación

Estructura de la petición y su equivalente generado en curl:

peticion-get.curl
Solo lectura 
# Comando cURL equivalente generado por Postman:
curl --location --request GET 'https://api.kilopolis.com/v1/productos?categoria=electronica&precio_min=100&precio_max=500&pagina=1&limite=20' \
--header 'Accept: application/json' \
--header 'User-Agent: PostmanRuntime/7.36.0'
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Para qué sirve la sintaxis de dos puntos (ejemplo: https://api.com/usuarios/:id) en la barra de URL de Postman?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Manual de Postman: Pruebas de APIs REST & Automatización y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

Conocer el Bootcamp

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de David Amador para Kilopolis Academia (Solucionáticos), estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.