Tema 9 · Variables & Entornos

Variables de Entorno: Conmutar entre Localhost y Producción con {{base_url}}

Aprende a crear Entornos en Postman, definir variables con la sintaxis {{variable}} y alternar entre local y producción con un solo clic.

Colecciones y Carpetas: Organización Modular de Endpoints Métodos de Autenticación: API Key, Basic Auth y Bearer Token (JWT)

El Error de Escribir URLs Fijas en las Peticiones

Si guardas 50 peticiones con la dirección escrita a mano como:
http://localhost:8000/api/v1/productos
¿Qué pasará cuando tengas que probar esa misma colección en el servidor de pruebas (Staging) o en el servidor real en la nube? Tendrías que editar las 50 URLs una por una, perdiendo horas de trabajo.

La solución profesional es utilizar Variables de Entorno y reemplazar el dominio fijo por la sintaxis de doble llave:
{{base_url}}/api/v1/productos

Cómo Crear tus Entornos (Local, Staging, Producción)

  1. En la barra lateral izquierda de Postman, haz clic en la sección Environments (Entornos) y pulsa en el botón + (Create Environment).
  2. Nombra tu primer entorno como "Localhost (Desarrollo)".
  3. Agrega la variable:
    • Variable: base_url
    • Type: default
    • Initial value: http://localhost:8000
    • Current value: http://localhost:8000
  4. Crea un segundo entorno llamado "Producción en la Nube" con:
    • Variable: base_url | Value: https://api.kilopolis.com
  5. El Selector de Entornos: En la esquina superior derecha de Postman, abre el menú desplegable de entornos. Cuando elijas "Localhost", tus peticiones apuntarán a tu máquina. ¡Si cambias a "Producción", toda tu colección apuntará inmediatamente al servidor en internet!

Diferencia Crítica de Seguridad: Initial Value vs Current Value

Campo de la Variable Dónde se Almacena Regla de Ciberseguridad
Initial Value (Valor Inicial) Se sincroniza con la nube de Postman y es visible para todo tu equipo. ¡NUNCA pongas contraseñas reales ni llaves privadas de Stripe/AWS aquí! Quedarían expuestas a otros colaboradores o en repositorios.
Current Value (Valor Actual) Permanece exclusivamente en tu computadora local y nunca se envía a los servidores de Postman. Aquí es donde debes almacenar tokens JWT privados, contraseñas de prueba locales y llaves secretas temporales.

⚡ Petición con Múltiples Variables Interpoladas

Ejemplo de URL y cabeceras dinamizadas con la sintaxis {{...}}:

request-con-variables.txt
Solo lectura 
-- URL con variables de entorno y parámetros dinámicos --
GET {{base_url}}/api/{{api_version}}/pedidos/{{ultimo_pedido_id}}

-- Cabeceras interpoladas --
Authorization: Bearer {{jwt_token}}
X-Client-Id: {{client_id}}
Accept: application/json

-- Valores resueltos automáticamente en entorno Localhost: --
-- https://localhost:8000/api/v1/pedidos/1084
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Por qué las contraseñas reales o llaves privadas de API deben colocarse en "Current Value" y no en "Initial Value" dentro de un Entorno 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.