Tema 3 · Interfaz & Paneles

Anatomía de la Interfaz: Pestañas de Petición, Parámetros y Respuesta

Domina los paneles clave de Postman: barra de URL, selector de métodos, configuración de parámetros y pestañas de visualización de respuesta.

Instalación de Postman Desktop y Configuración del Espacio de Trabajo Peticiones GET y Parámetros de Consulta (Query Params)

Estructura Visual de Postman

La interfaz de Postman está dividida verticalmente en dos grandes secciones: el Constructor de Petición (Request Builder) en la mitad superior y el Visor de Respuestas (Response Viewer) en la mitad inferior.

Anatomía de la Interfaz de Peticiones en Postman

1. El Constructor de Petición (Request Builder)

Componente Función Técnica
Selector de Método Menú desplegable donde eliges el verbo HTTP (GET, POST, PUT, PATCH, DELETE). Cada uno tiene un color distintivo.
Barra de URL Dirección del endpoint de destino. Permite interpolar variables de entorno dinámicas encerradas en dobles llaves: {{base_url}}/api/v1/usuarios.
Pestaña Params Tabla gráfica de clave-valor para parámetros de consulta (Query Params). Postman los concatena automáticamente a la URL con ? y &.
Pestaña Authorization Configuración de credenciales de seguridad (Bearer Token, Basic Auth, API Key) que se inyectan en las cabeceras de red.
Pestaña Headers Cabeceras HTTP de la petición (ej. Content-Type: application/json o Accept: application/json).
Pestaña Body Cuerpo del mensaje para métodos de escritura (POST, PUT, PATCH). Permite seleccionar raw ➔ JSON, form-data o x-www-form-urlencoded.

2. El Visor de Respuesta (Response Viewer)

Al pulsar el botón azul Send, la mitad inferior cobra vida con métricas cruciales:

  • Status Code: Código numérico devuelto por el servidor (ej. 200 OK, 201 Created, 404 Not Found).
  • Time (Latencia): Tiempo total de ida y vuelta en milisegundos (ms).
  • Size: Peso total transferido en bytes o kilobytes.
  • Modos de Visualización del Body:
    • Pretty: Formatea y resalta el JSON con colores legibles y sangría.
    • Raw: Texto crudo sin procesar.
    • Preview: Renderiza HTML en caso de que el endpoint haya devuelto una página web o un error 500.
  • Pestaña Test Results: Muestra el conteo de pruebas pasadas o fallidas (ej. 3/3 PASS).

⚡ Respuesta Estándar de una API REST formateada en Pretty JSON

Ejemplo de carga recibida e inspeccionada en el visor inferior de Postman:

respuesta-api.json
Solo lectura 
{
  "meta": {
    "version": "v1.0",
    "timestamp": 1794200000,
    "total_registros": 42
  },
  "data": [
    {
      "id": 1,
      "codigo": "KILO-PRO-01",
      "titulo": "Curso de Backend con PHP 8.3",
      "instructor": "Kilopolis Academia",
      "activo": true,
      "tags": ["php", "api", "rest", "mysql"]
    }
  ]
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
En el visor de respuesta inferior de Postman, ¿qué vista debes seleccionar para ver el JSON estructurado con sangría, colores e indentación legible?
🦉
¿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.