Importar y exportar

Cambiar de cliente de APIs no debería significar perder años de trabajo. Echo importa desde las herramientas que probablemente ya utilizas y nunca te impide sacar tus datos.

Importa desde Postman

Echo importa colecciones y entornos de Postman, ambos con total fidelidad de ida y vuelta. La estructura de carpetas, las peticiones y las variables llegan intactas, y puedes volver a exportar a los formatos de Postman en cualquier momento. Probar Echo no es un camino sin vuelta atrás.

  1. Exporta tus colecciones y entornos desde Postman.
  2. Importa los archivos en Echo.
  3. Comprueba que tus peticiones se resuelven con los entornos importados y continúa trabajando.

Importa desde Insomnia y Bruno

Si vienes de Insomnia o Bruno, el proceso es el mismo: exporta desde tu herramienta actual e importa en Echo. Tus peticiones llegan a colecciones que puedes reorganizar de inmediato con las herramientas descritas en /docs/echo/collections-and-sharing.

Importa una especificación OpenAPI 3

Proporciona a Echo un documento OpenAPI 3, en JSON o YAML, y creará peticiones a partir de la especificación con inferencia automática del tipo de petición. Así, las operaciones entran como el tipo de petición correcto en vez de como un conjunto de borradores genéricos. Es la forma más rápida de empezar a explorar una API cuyo contrato tienes, pero a la que nunca has llamado.

Importa un comando cURL

Pega un comando cURL y Echo lo convierte en una petición completa. Resulta útil para los comandos que aparecen en informes de errores, documentación de APIs e historiales del terminal. Si tu organización tiene licencias Pro AI, también hay una importación de cURL asistida por IA para los casos más complicados. Consulta /docs/echo/ai-features.

Exporta tu trabajo

Exporta colecciones a los formatos de Postman o a OpenAPI 3.1 en JSON. Con OpenAPI obtienes una especificación para usar en otras herramientas de APIs. La exportación a Postman mantiene disponible tu flujo de trabajo con colecciones.

Mantén una colección en una carpeta

Vincula una colección a una carpeta para mantener sus peticiones y entornos en archivos JSON legibles junto a tu proyecto. Puedes revisar los cambios con tus herramientas habituales e incluir los archivos en el control de versiones.

Echo muestra si hay cambios en la aplicación, en la carpeta o en ambas. Elige importar o exportar para aplicarlos; vincular una carpeta no hace commit ni push en Git. Los valores secretos quedan fuera de los archivos exportados. Usa referencias a variables para las credenciales y revisa los archivos antes de compartirlos.

Publica documentación de APIs en DocuVault

La exportación de documentación publica una colección como documentación de API en Markdown dentro de Gapfy DocuVault. En lugar de una página wiki que queda desactualizada, el espacio documental de tu equipo recibe documentación generada desde la colección que realmente ejecutas.

  1. Elige la colección que quieras documentar.
  2. Ejecuta la exportación de documentación.
  3. Encuentra en DocuVault la documentación de API en Markdown generada, lista para compartirla con tu equipo.

Comparte documentación mediante un enlace

Con un plan de pago de Echo y los permisos necesarios, publica la documentación de una colección sincronizada y copia su enlace público. Puedes publicar una versión actualizada, cambiar el enlace o revocar la publicación. Cualquier persona con el enlace público puede leer el contenido, así que revísalo antes de compartirlo. Esta publicación es independiente de la exportación de Markdown a DocuVault.

Próximos pasos

  • Organiza lo que has importado: /docs/echo/collections-and-sharing
  • Conecta las peticiones importadas con los entornos: /docs/echo/environments-and-variables