01
Elige el tipo de origen
Cambiar de dirección no reemplaza el texto. Después carga el ejemplo del modo o un archivo adecuado. La colección debe declarar el esquema 2.1 y el entorno debe contener un arreglo values.
Herramientas API
Postman a OpenAPIrevisa lo que se convierte
Carga una colección, una especificación o un entorno y comprueba las solicitudes y el informe antes de exportar.
Postman a OpenAPI
Colección, especificación o entorno
Resultado
El texto permanece en este navegador. No se envían solicitudes API ni se ejecutan scripts o descargan referencias.
Opciones de salida
Se convierten ejemplos, no un contrato completo. Revisa el informe y los marcadores pendientes.
500.000 caracteres · profundidad 60 · 50.000 nodos · 1.000 solicitudes · 500 avisos · 5 segundos.
Resultado desactualizado. Valida otra vez antes de exportar.
La copia y la descarga incluyen toda la vista seleccionada. Solo se ocultan valores en la salida.
Postman a OpenAPI ayuda a convertir una colección de llamadas que funcionan en un punto de partida para documentar una API. Una solicitud representa un caso concreto; un contrato describe las entradas admitidas. Por eso conviene saber qué información no pasa de un archivo al otro.
Si partes de una especificación, conserva el documento original junto a la colección generada. Los marcadores de autenticación, las respuestas y las restricciones de los esquemas necesitan revisión antes de utilizar las solicitudes.
Por qué revisar Postman a OpenAPI aquí
Solicitudes y omisiones en el mismo lugar
Postman a OpenAPI recorre las carpetas anidadas y utiliza su ruta como etiqueta de la operación. La lista muestra las llamadas leídas; el informe identifica scripts, variables y campos sin correspondencia. Dos solicitudes con la misma ruta y método detienen la conversión para evitar sobrescrituras.
Comprueba los secretos antes de compartir
El formato de colecciones y la exportación del entorno ocultan credenciales de forma predeterminada. Los valores sensibles reconocidos se sustituyen en la salida. Las filas desactivadas se informan por separado para explicar por qué el archivo .env tiene menos entradas.
Tres decisiones antes de guardar
02
Espera a que el resultado esté actualizado
La conversión automática espera 350 ms tras el último cambio. Desactívala para editar varias partes y ejecutar con Ctrl/Cmd + Enter. Cambiar la entrada o las opciones bloquea la copia y la descarga hasta que termine la nueva conversión.
03
Exporta la vista que has comprobado
Resultado guarda el documento convertido, Solicitudes la lista completa e Informe todos los códigos y rutas de origen. Se muestran 50 filas cada vez, pero la descarga incluye todos los elementos de la vista elegida.
De los ejemplos al contrato y al entorno
Dos direcciones de conversión
Puedes convertir una colección Postman en OpenAPI 3.0.3 con salida JSON o YAML. OpenAPI a Postman acepta 3.0 y 3.1 y genera Collection 2.1. Las referencias locales necesarias para los detalles de las operaciones se resuelven dentro del documento suministrado.
Ejemplos sin restricciones inventadas
Los valores de query y cabeceras se convierten en ejemplos de cadenas. El cuerpo JSON sigue siendo un ejemplo, sin añadir required ni enum a partir de un único caso. En sentido inverso se usa example o default; si falta, se crea un marcador con nombre.
Autenticación y servidores previsibles
Se trasladan Basic, Bearer y API Key en cabeceras o query. La conversión inversa prioriza operación, ruta y raíz y toma el primer servidor efectivo. Varias alternativas, servidores ausentes y combinaciones complejas de seguridad se indican en el informe.
Configuración de entorno independiente
Las variables de entorno proceden de un JSON exportado por separado. Los valores escalares activos pasan a cadenas y null queda vacío. Las comillas preservan espacios, saltos de línea y dólares literales. Las claves inválidas o repetidas impiden exportar.
Información que debe completarse después
- Versiones delimitadas
- Se aceptan Collection 2.1 y OpenAPI 3.0.x o 3.1.x. Las búsquedas Postman Swagger pueden referirse a Swagger 2.0, que aquí no se lee ni se genera. También se rechazan otras versiones de colección y OpenAPI 3.2.
- Sin ejecución de scripts ni variables
- Los scripts previos y las pruebas no se ejecutan ni se traducen a aserciones. El formato conserva su texto; la conversión informa de su omisión. No se evalúan variables dinámicas ni se mezclan automáticamente los ámbitos de entorno, globales o Vault.
- La colección no conserva todo el contrato
- La dirección inversa omite definiciones de respuesta y restricciones de validación, y lo informa. Quedan fuera la serialización compleja, callbacks, webhooks, flujos OAuth, firmas y contenido de archivos binarios. Un ejemplo no demuestra todas las reglas del servicio.
- Referencias y servidores incompletos
- No se descargan referencias externas. Un destino local ausente o una especificación inválida detienen el proceso. Una variable base no resuelta produce un servidor /; sin servidor en la dirección inversa se usa example.invalid. Ambos casos requieren revisar el informe.
- Ocultar credenciales tiene límites
- Se reconocen nombres sensibles, variables secret, valores de autenticación, cookies y credenciales en URL. Se inspeccionan los cuerpos JSON y se ocultan por completo los demás. Puede quedar un secreto dentro de texto libre o scripts. La entrada original no se modifica.
- Límites de trabajo
- Hasta 500.000 caracteres de entrada, profundidad 60, 50.000 nodos, 1.000 solicitudes, 500 avisos, 2.000.000 caracteres para el resultado completo y cinco segundos de proceso. Se rechazan claves duplicadas, números imprecisos, alias YAML, etiquetas propias y documentos múltiples.
Preguntas sobre Postman a OpenAPI
¿Se aceptan especificaciones YAML y JSON?
Sí, en el modo OpenAPI → colección. Las colecciones y entornos deben estar en JSON. La selección de formato solo afecta a la especificación generada; las colecciones salen en JSON y los entornos en .env.
¿Se pierde información al convertir en ambas direcciones?
Sí. Un flujo ejecutable y un contrato declarativo contienen información distinta. Revisa todos los avisos y considera el resultado un inicio de migración. La conversión no valida las credenciales ni las respuestas de un servicio real.
¿Cómo se configura baseUrl al generar una colección?
Se prioriza operación > ruta > raíz. La primera URL efectiva se guarda en baseUrl y las operaciones siguientes reciben variables base independientes. Se sustituyen los valores predeterminados de variables de servidor. Si no hay servidor, se usa example.invalid y se avisa.
¿Se puede impedir que se exporten variables secretas?
Con el ocultamiento activado, los valores marcados secret o reconocidos por un nombre sensible se sustituyen por [REDACTED]. Esto controla la salida de esta herramienta, no los permisos de Postman. No detecta todos los secretos dentro de texto arbitrario.
¿Se pueden incluir todas las variables de entorno al exportar una colección?
No automáticamente. Exporta el entorno por separado y úsalo en Entorno → .env. Solo se procesan los valores activos de ese archivo. No se recuperan valores locales, globales o de Vault que no estén incluidos.
¿Un documento da un resultado inesperado?
Empieza con pocas solicitudes
Prueba Postman a OpenAPI con una colección pequeña, compara la lista y el informe con el original y completa los marcadores pendientes antes de guardar el archivo que necesitas.