Importación y exportación

Echo permite traer peticiones de otro cliente de APIs, guardar una colección junto al código y generar documentación para otras personas. Estas operaciones producen resultados distintos y tratan los secretos de forma diferente.

Importa una colección o un entorno

1. Exporta desde la herramienta actual y conserva el archivo original.
2. Abre la sección de importación en Ajustes de Echo, selecciona el espacio de destino y el archivo de origen. Echo detecta el formato.
3. Revisa la vista previa, las cantidades y los avisos antes de confirmar.
4. Abre una petición importada, selecciona su entorno y comprueba URL, autenticación, cuerpo y scripts antes de enviarla.

Echo admite colecciones y entornos de Postman. Cuando es compatible, la autenticación heredada de Postman se copia a las peticiones importadas; no crea autenticación editable en la colección de Echo. Los cuerpos binarios y las referencias a archivos no se trasladan sin más entre equipos y pueden omitirse con un aviso. La autenticación no compatible también genera un aviso. Vuelve a adjuntar los archivos y corrige las credenciales antes de usar esas peticiones.

Las exportaciones de Insomnia y las colecciones de Bruno ofrecen otras vías de migración. Sus modelos de datos son distintos. Revisa el resultado en vez de suponer que todas las funciones originales sobrevivirán a una exportación y una nueva importación.

Empieza con OpenAPI o cURL

Importa un documento OpenAPI 3 en JSON o YAML para crear peticiones a partir de sus operaciones. Comprueba las URL, parámetros, cuerpos y opciones de seguridad generados. Una especificación describe una API; importarla no demuestra que el servidor la implemente.

El asistente de importación cURL usa IA y exige una licencia Pro AI. Ábrelo desde la paleta de comandos o el menú de nueva petición y pega el comando. Revisa URL, método, cabeceras y cuerpo propuestos antes de crearla. Comprueba credenciales y archivos referenciados antes de enviarla. Consulta funciones de IA para conocer el acceso y el tratamiento de los datos.

Elige un formato de exportación

La exportación a Postman permite usar las colecciones en esa herramienta; la exportación de entornos crea un archivo separado. Los entornos exportados a Postman incluyen los valores secretos, marcados como secretos en el archivo. Trata esos archivos como credenciales, no como adjuntos seguros para compartir.

La exportación OpenAPI genera un documento OpenAPI 3.1 JSON para operaciones HTTP. Los demás protocolos se cuentan como excluidos; este formato no es una copia de seguridad de todo el espacio de trabajo. Revisa el resultado y la especificación. Los valores secretos del entorno se omiten de las variables del servidor, pero las credenciales escritas literalmente en las peticiones requieren revisión.

Vincula una colección a una carpeta

Desde el menú de la colección, vincula una carpeta vacía en la que puedas escribir. Echo crea archivos JSON legibles para la colección, las peticiones y los entornos. Usa una carpeta separada para cada árbol vinculado; no se permiten vínculos superpuestos.

El panel informa de cambios en Echo, en disco o en ambos. Exportar lleva la versión de Echo a la carpeta; importar trae la versión de la carpeta a Echo. Si ambas cambiaron, revisa el conflicto y elige expresamente cuál aplicar. La importación automática es opcional. Desvincular no elimina la colección ni los archivos.

Este formato omite los valores de variables secretas, aunque puede conservar referencias a secretos. Es una protección distinta a la exportación de entornos de Postman. Usa variables para las credenciales y revisa scripts, cuerpos y cabeceras antes de hacer commit. Echo no hace commit ni push en Git. La CLI de escritorio usa el mismo formato.

Exporta Markdown a DocuVault

Inicia sesión, selecciona una colección y elige la exportación de documentación. Echo genera Markdown y lo envía a DocuVault. Si ya existe un documento con el mismo nombre generado, recibe una nueva versión. Comprueba el mensaje de finalización y el archivo antes de compartirlo.

Repite la exportación tras cambiar la colección. El documento representa ese momento; no sigue automáticamente cada edición.

Publica documentación mediante un enlace público

Para una colección sincronizada, el panel permite a personas autorizadas con un plan de pago de Echo publicar una versión, copiar su URL, actualizarla, cambiar el enlace o revocar el acceso. Cualquier persona con el enlace público puede leer el documento. Revisa ejemplos y credenciales antes de publicar.

Publica de nuevo tras modificar la colección. Cambiar el enlace sustituye la URL de los lectores; revocar interrumpe el acceso a la publicación. Ninguna de las dos acciones recupera copias ya descargadas. Esta publicación es independiente del archivo de DocuVault.

Para reutilizar configuraciones, consulta entornos. Para convertir C#, TypeScript, JavaScript, Java, Python o JSON Schema, consulta contratos.