En Apidog 2.8.47–2.8.50, las actualizaciones de este mes facilitan el mantenimiento de la automatización de API, la integración de repositorios y la documentación de API, desde importaciones modulares de CLI y creación de casos de depuración hasta Bitbucket Cloud, conexiones autohospedadas de GitLab y esquemas publicados desde subsitios de Docs.
Esta versión busca que la automatización y la colaboración con Git requieran menos desvíos en la configuración.
Las actualizaciones de Apidog de septiembre se centran en los puntos donde los equipos a menudo pierden tiempo: la gestión de grandes estructuras de proyectos desde scripts o flujos de trabajo de IA, la importación de activos de API en el módulo correcto, la creación de activos de prueba sin salir de la terminal y la conexión de proveedores de Git existentes sin cambiar la forma en que los equipos ya trabajan.
Un vistazo:
- Automatización con Apidog CLI: gestione módulos de proyecto, importe datos de API multiformato por módulo y cree casos de prueba de depuración a partir de archivos de configuración.
- Integraciones de repositorios Git: agregue conexiones de Bitbucket Cloud y GitLab On-Premise a los flujos de trabajo de importación/exportación de proyectos.
- Usabilidad diaria: manejo más claro de URL, mejor filtrado de informes de prueba, completado de variables de datos de prueba y una lista de proyectos más rápida.
- Visibilidad de Docs y rendimiento: los subsitios de Docs publican esquemas, y las pruebas de rendimiento informan los tiempos de respuesta P95 y P99.
🤖 Apidog CLI para automatización de API y flujos de trabajo de IA
Apidog CLI ya se ha convertido en un punto de entrada útil para las ejecuciones de pruebas de CI y la automatización. Esta versión lo extiende a una etapa anterior del flujo de trabajo: los equipos pueden gestionar la estructura del proyecto, llevar datos al módulo correcto y crear casos de depuración antes de ejecutar las pruebas.
Gestionar módulos de proyecto desde la CLI
Apidog CLI ahora puede consultar, crear, actualizar y eliminar módulos de proyecto.
Esto es útil cuando la estructura del módulo necesita cambiar como parte de un flujo de trabajo automatizado. Después de una operación de escritura, la CLI devuelve un JSON estructurado que incluye el moduleId, para que los scripts y agentes puedan pasar el identificador a pasos posteriores de importación, prueba o mantenimiento en lugar de pedir a alguien que lo copie de la interfaz de usuario.
Eso hace que la gestión de módulos forme parte del mismo ciclo repetible que las pruebas de API y la automatización de CI.
Importar datos de API a un módulo seleccionado
El comando de importación de la CLI ha sido refactorizado para reutilizar las capacidades de análisis del cliente de Apidog. Puede importar datos de API desde fuentes compatibles a un módulo de proyecto especificado en lugar de crear primero los datos en la interfaz de usuario y moverlos más tarde.
Para migraciones más grandes, los resultados de la importación incluyen recuentos de elementos agregados, actualizados, ignorados y eliminados. Esto facilita que los scripts, los trabajos de CI y los agentes de IA verifiquen lo sucedido antes de pasar al siguiente paso.
Esto es especialmente útil cuando múltiples formatos necesitan aterrizar en la misma estructura de proyecto con menos pasos de limpieza manual.
Crear casos de prueba de depuración a partir de la configuración
Los usuarios de la CLI ahora pueden crear casos de prueba de depuración de interfaz a partir de archivos de configuración. Una configuración puede definir el nombre del caso, la API objetivo, los parámetros de la solicitud, el cuerpo de la solicitud, la autenticación, los pre-procesadores, los post-procesadores y la validación de la respuesta.
Después de la creación, el caso de depuración se puede abrir, editar y ejecutar en Apidog como cualquier otro caso de depuración. Esto es útil cuando la automatización o un agente prepara el activo de prueba inicial, pero un desarrollador aún desea inspeccionarlo y refinarlo visualmente.
Juntos, la gestión de módulos, las importaciones estructuradas y la creación de casos de depuración reducen el trabajo manual en scripts locales, pipelines de CI/CD y flujos de trabajo asistidos por IA.
Si ya tiene Apidog CLI instalado, actualícelo antes de usar las nuevas capacidades:
npm install -g apidog-cli@latestConsulte la documentación de Apidog CLI para la referencia de comandos más reciente.
🔗 Integraciones de repositorios Git
Septiembre también amplía la importación/exportación basada en Git a dos entornos de repositorio comunes.
Bitbucket Cloud
La importación y exportación de proyectos ahora son compatibles con los repositorios de Bitbucket Cloud. Los equipos que ya utilizan Bitbucket Cloud pueden mantener sus repositorios existentes en el flujo de trabajo en lugar de mover los activos de la API a otra plataforma Git.
GitLab On-Premise
Las organizaciones pueden configurar una instancia de GitLab On-Premise en Apidog SaaS y usarla en flujos de trabajo de repositorios Git compatibles. Cada organización gestiona su propia conexión de forma independiente, por lo que los equipos pueden seguir utilizando su configuración de GitLab autohospedada existente.
Antes de conectarse, confirme que la dirección de la instancia de GitLab y el entorno de red cumplen los requisitos de conexión.
⚙️ Mejoras Diarias
La versión también aborda la retroalimentación frecuente del trabajo diario con API.
Las URL completas ya no compiten con la ruta del entorno
Al crear o editar una API HTTP, introducir una URL completa que comience con http:// o https:// ahora oculta la ruta del entorno inmediatamente. Volver a cambiar el valor a una ruta relativa restaura la ruta del entorno.
Esto elimina la confusión de ver una URL completa y una ruta de entorno al mismo tiempo, y elimina la necesidad de guardar primero para ver el comportamiento.
Filtrado de informes de prueba más útil
Las listas de informes de prueba ahora admiten el filtrado por ejecutor (runner) y fuente de ejecución. También se han agregado campos de visualización relacionados, lo que facilita acotar una larga lista de informes y comparar registros recientes de diferentes orígenes.
Las variables de datos de prueba aparecen en el autocompletado
Las variables de datos de prueba existentes ahora aparecen tanto en el autocompletado de código como en el autocompletado de valores dinámicos. Al escribir solicitudes o pruebas, puede buscar y seleccionar la variable directamente en lugar de volver a la lista de variables para copiar su nombre.
Listas de proyectos más rápidas
Apidog optimizó el tiempo de respuesta de la API de lista de proyectos. Las listas de proyectos se cargan más rápido al ingresar a un espacio de trabajo o localizar un proyecto, lo que reduce el tiempo de espera durante la navegación y el cambio frecuentes.
✨ También en esta versión
Tres cambios completan el mes, abarcando la documentación, las pruebas de rendimiento y la configuración de proyectos con enfoque en la especificación.
Publicar esquemas desde los subsitios de Docs
Los subsitios en Apidog Docs ahora pueden publicar esquemas junto con los endpoints, para que los lectores de un sitio publicado puedan verlos en su lugar en lugar de volver al sitio principal. Los subsitios empresariales pueden habilitar esta capacidad por sí mismos.
Tiempos de respuesta P95 y P99 en pruebas de rendimiento
Los resultados de las pruebas de rendimiento ahora informan los tiempos de respuesta P95 y P99 junto con las métricas existentes. Los percentiles describen la cola lenta que los promedios ocultan, que suele ser la parte de una API que los usuarios realmente notan.
Configuración de proyectos en modo Spec e importación de OpenAPI
Los proyectos en modo Spec ahora se abren en un estado vacío más claro, con los puntos de entrada de importación y creación de OpenAPI directamente visibles, de modo que un proyecto centrado en la especificación puede comenzar sin buscar la forma de hacerlo.
🛠️ Soluciones y Mejoras Adicionales
Este ciclo también incluye las siguientes soluciones y cambios menores:
- Mejorada la forma en que se muestran el estado de la prueba y las acciones en la ventana principal y la barra de pestañas.
- Mejorada la forma en que aparecen las invitaciones pendientes en las listas de organizaciones y miembros del equipo.
- Corregido un problema por el cual las variables de autenticación básica en el código de solicitud generado no se expandían y se codificaban directamente como Base64.
- Corregido un problema por el cual la edición de una pestaña no expandía los campos de modelo de datos combinados referenciados usando
allOf. - Corregido un problema por el cual las referencias cruzadas de proyectos de API a modelos de datos eran incorrectas después de clonar o copiar un proyecto.
- Corregido un problema por el cual los casos de depuración creados por la CLI mostraban el tipo de autenticación como "Sin autenticación" en el cliente web y no aplicaban la autenticación.
- Corregido un problema por el cual las definiciones `$ref` de respuesta de OpenAPI se descartaban silenciosamente durante la importación de la CLI.
- Corregido un problema por el cual los metadatos de paginación de la lista de informes devolvían valores `pageSize` y `pageIndex` incorrectos.
- Corregido un problema por el cual generar informes de prueba JUnit y HTML hacía que el informe JUnit contuviera solo el resultado del último caso de prueba.
- Corregido un problema por el cual el desplegable de entorno no se podía abrir al cambiar los entornos de URL en las pruebas de API individuales.
- Se añadió soporte para deshabilitar la entrada de recompensa por invitación en la página de inicio a través de la Política Empresarial.
Para la lista completa elemento por elemento, explore el Changelog de Apidog.
🌟 Qué Significa Esto
Septiembre es una versión práctica para equipos cuyo trabajo abarca cada vez más personas, scripts, agentes y repositorios Git.
| Enfoque | Qué mejora | Por qué es importante |
|---|---|---|
| CLI y automatización | Los módulos, importaciones y casos de depuración se pueden crear y gestionar a través de la CLI. | La automatización y los agentes pueden participar antes sin configuración manual de la interfaz de usuario. |
| Colaboración con Git | Bitbucket Cloud y GitLab On-Premise se conectan a los flujos de trabajo del proyecto. | Los equipos pueden mantener los repositorios que ya operan. |
| Calidad diaria | Mejora el manejo de URL, el filtrado de informes, el completado de variables y la carga de proyectos. | Los pasos comunes de configuración y revisión requieren menos atención. |
| Docs, pruebas y especificaciones | Los esquemas se publican con los subsitios de Docs, los resultados de rendimiento informan P95 y P99, y el modo Spec tiene un inicio más claro. | Los esquemas, la latencia y el contexto basado en la especificación son visibles sin salir del flujo de trabajo. |
💬 Mantente en Contacto
¿Tiene comentarios o preguntas? Conéctese con otros ingenieros de API y el equipo de Apidog:
- Únase a nuestra comunidad de Discord para discusiones y soporte en tiempo real.
- Participe en nuestra comunidad de Slack para conversaciones técnicas.
- Síganos en X (Twitter) y LinkedIn para las últimas actualizaciones.
P.D. Para cada detalle de esta versión, consulte el Changelog de Apidog.
Saludos cordiales,
El equipo de Apidog