Saltar al contenido

Convertidor de OpenAPI a colección de Postman

Convierte un documento OpenAPI o Swagger en una colección de Postman v2.1 lista para importar.

Entrada

Convertidor de OpenAPI a colección de Postman

Pega un documento OpenAPI 3 o Swagger 2 — en JSON o YAML — y esta herramienta construye una colección de Postman v2.1 que puedes importar directamente en Postman, Insomnia o cualquier cliente que lea el formato. Cada operación en la especificación se convierte en una solicitud, organizada en carpetas para que una API grande se mantenga navegable en lugar de aterrizar como una lista plana.

Agrupa las solicitudes por etiqueta o por el primer segmento de ruta, lo que sea que coincida con cómo tu equipo ya piensa en la API. Activa "Insertar URL base como una variable de entorno" para cambiar la URL del servidor por una variable {{baseUrl}}, para que cambiar entre staging y producción sea un único cambio de entorno en lugar de editar cada solicitud. "Agregar encabezados de autenticación desde el esquema de seguridad" lee las definiciones de bearer, clave de API u OAuth2 de la especificación y agrega el encabezado de Autorización o clave coincidente como un marcador de posición. "Generar cuerpos de solicitud de ejemplo a partir de esquemas" construye un ejemplo JSON para cada solicitud a partir de su esquema, siguiendo referencias de $ref dentro del documento, para que las solicitudes POST y PUT lleguen pre-rellenadas en lugar de vacías. Los parámetros de consulta pueden incluirse con sus descripciones, los extremos obsoletos pueden omitirse por completo, y se puede agregar un script de prueba básico que verifique un código de estado exitoso a cada solicitud.

Los parámetros de ruta como {id} se convierten automáticamente en variables de ruta :id de Postman, y los finales de línea CRLF y LF en un documento pegado se tratan igual. Las especificaciones grandes con cientos de operaciones se convierten en un único paso; si la colección superaría el límite de salida, lo indica en lugar de congelar la pestaña.

Todo sucede localmente en tu navegador — el documento que pegas, incluidos los detalles internos de la API que contiene, nunca se carga en ningún lugar. Cuando la colección está lista, cópiala, descárgala como archivo o envíala a la entrada de otra herramienta para seguir trabajando en ella.

Preguntas frecuentes

¿Admite documentos OpenAPI 3 y Swagger 2?
Sí. Lee los "servers" y "components.securitySchemes" de OpenAPI 3, así como "host"/"basePath"/"schemes" y "securityDefinitions" de Swagger 2, y acepta JSON o YAML.
¿Qué esquemas de seguridad reconoce?
Autenticación HTTP bearer y básica, claves de API en un encabezado, parámetro de consulta o cookie, y OAuth2/OpenID Connect — cada uno se asigna al encabezado de marcador de posición correspondiente o parámetro de consulta.
¿Cómo se generan los cuerpos de solicitud de ejemplo?
A partir de los valores "example" o "default" propios del esquema de la solicitud donde estén presentes, retrocediendo a un marcador de posición apropiado para el tipo — las referencias de $ref se resuelven dentro del mismo documento.
¿Qué sucede con $ref que apunta fuera del documento?
Se resuelven como null en el ejemplo generado en lugar de ser seguidos en cualquier lugar — nada en esta herramienta realiza una solicitud de red.
¿Se carga mi documento de API en algún lugar?
No. La conversión se ejecuta completamente en tu navegador — el documento y todo lo que contiene permanecen en tu dispositivo.