¿Cómo crear una cuenta en Postman?

Hay que dirigirse al siguiente enlace de Postman y enlazar tu cuenta en la plataforma que se estime conveniente.

¿Cómo crear una colección de API GATEWAY en Postman?

Para poder crear la colección de Postman debes importarla directamente desde el archivo OpenAPI de API Gateway.

Paso 1: Importar el schema OpenAPI

Puedes importar el schema de dos formas:

a. Desde URL: Copia la URL del schema (https://app.apigateway.cl/schema/api/) y en Postman selecciona “Import” > “Link” y pega la URL. Postman detectará automáticamente el archivo OpenAPI.

b. Desde archivo: Descarga el archivo YAML y luego en Postman selecciona “Import” > “File” y elige el archivo descargado.

A continuación se muestra un ejemplo de importación desde URL. Postman detectará automáticamente el schema una vez que pegues la URL:

Paso 2: Configurar la importación

Antes de finalizar la importación, haz clic en “View Import Settings”.

Cambia la opción “Folder organization” de “Paths” a “tags”. Esto organizará mejor los endpoints en la colección agrupándolos por categorías.

Una vez realizado el cambio, la pantalla mostrará la opción seleccionada. Finalmente, haz clic en el botón “Import” para completar la importación.

Configuración después de importar

Importar el schema OpenAPI no deja lista la autenticación: cada usuario debe configurar en Postman la autorización de la colección y el valor del token después de importar.

Autorización de la colección

1. Abre la colección importada (no una petición suelta).
2. Ve a la pestaña Authorization.
3. En Type, elige API Key.
4. Indica que la clave va en Header, con Key Authorization y Value Token {{API_TOKEN}} (la palabra Token, un espacio y la variable; el secreto va solo en API_TOKEN).
5. En la misma colección, abre la pestaña Variables y crea API_TOKEN con tu token de API Gateway (solo la clave, sin el prefijo Token ).

Si prefieres no guardar el token en variables de colección, puedes definir API_TOKEN en un Environment y seleccionar ese entorno en el selector superior derecho; las referencias {{API_TOKEN}} seguirán resolviéndose igual.