Las actualizaciones de junio facilitan la automatización y la confianza en los flujos de trabajo API cotidianos: operaciones de CLI preparadas para IA, importaciones más limpias, actualización automática de OAuth 2.0 y mejoras prácticas solicitadas por usuarios.
Esta versión se centra en los puntos donde los equipos de API suelen perder tiempo:
- Dar a los agentes de IA acceso estructurado a recursos reales del proyecto.
- Reducir la limpieza posterior a importaciones desde Postman, OpenAPI o Swagger.
- Mantener funcionando solicitudes protegidas por OAuth 2.0.
- Acelerar tareas repetitivas de pruebas, configuración y depuración.
A continuación, los cambios principales y cómo aplicarlos en tu flujo de trabajo.
Nuevas actualizaciones
Apidog CLI soporta flujos de trabajo API impulsados por IA
Apidog CLI se está convirtiendo en una capa de ejecución para flujos de trabajo API impulsados por IA.
En la práctica, esto permite que los agentes de IA trabajen con activos reales de Apidog de forma más estructurada, en lugar de depender solo de instrucciones en lenguaje natural o información no estructurada.
Con las capacidades actuales de la CLI, los agentes pueden:
- Leer recursos del proyecto.
- Escribir cambios.
- Validar operaciones estructuradas.
- Exportar datos.
- Ejecutar flujos de trabajo de prueba con mayor fiabilidad.
Qué cambia este mes
Apidog CLI añade mejoras orientadas a automatización:
- Puede servir como capa de ejecución para agentes de IA que operan con recursos de proyectos de Apidog.
- Soporta la ejecución de casos de prueba.
- Los casos de escenario pueden hacer referencia a endpoints, casos de prueba y otros escenarios.
- Las exportaciones en formato nativo y OpenAPI admiten un control de alcance más granular.
Cómo aplicarlo en tu flujo de trabajo
Un flujo recomendado sería:
- Usa Apidog como fuente de verdad para endpoints, escenarios y casos de prueba.
- Expón esos recursos a través de Apidog CLI.
- Permite que el agente de IA proponga cambios o genere operaciones.
- Valida los cambios antes de escribirlos de vuelta en el proyecto.
- Ejecuta los casos de prueba relacionados desde la CLI.
Ejemplo de flujo conceptual:
Agente de IA
-> lee recursos del proyecto mediante Apidog CLI
-> genera cambios o escenarios
-> valida la estructura
-> ejecuta casos de prueba
-> escribe cambios aprobados en Apidog
Cuando se combina con las Habilidades de Apidog, la CLI proporciona a los agentes instrucciones más claras y límites operativos más seguros. Esto ayuda a que los agentes comprendan mejor cómo usar los recursos de Apidog, validen cambios generados antes de guardarlos y completen tareas de API con menos conjeturas.
Piensa en la CLI como el puente entre instrucciones de IA en lenguaje natural y operaciones estructuradas dentro del proyecto Apidog.
Mejoras en importación y exportación
Esta versión también mejora flujos de importación y exportación para equipos que migran desde Postman o mantienen definiciones con OpenAPI y Swagger.
Importaciones desde la API de Postman
Al importar datos mediante la API de Postman, Apidog ahora puede eliminar espacios de los nombres de variables.
Esto reduce trabajo manual después de la importación y evita problemas derivados de nombres inconsistentes.
Ejemplo:
Antes:
base url
access token
Después:
baseurl
accesstoken
También, al importar espacios de trabajo mediante la API de Postman, Apidog puede renombrar espacios llamados “Mi Espacio de Trabajo” basándose en el creador del espacio de trabajo.
Esto es útil cuando un equipo importa varios workspaces y necesita identificarlos rápidamente.
Importación/exportación OpenAPI y Swagger
La compatibilidad con OpenAPI y Swagger también se amplía.
Apidog ahora soporta durante la importación/exportación:
- Parámetros de tipo objeto.
- Parámetros de tipo referencia.
Esto ayuda a conservar estructuras de especificación más completas y reduce los ajustes manuales después de importar o exportar.
| Antes | Ahora |
|---|---|
|
|
Checklist para migraciones
Antes de importar:
- Revisa los nombres de variables en Postman.
- Identifica workspaces con nombres genéricos.
- Valida si tu especificación OpenAPI/Swagger usa parámetros
objecto$ref.
Después de importar:
- Comprueba que las variables quedaron limpias.
- Verifica que los workspaces sean fáciles de identificar.
- Ejecuta pruebas básicas sobre endpoints críticos.
- Exporta una muestra en OpenAPI/Swagger para validar la estructura resultante.
OAuth 2.0 ahora soporta actualización automática de tokens
La autenticación OAuth 2.0 ahora soporta actualización automática de tokens.
Cuando un token de acceso está cerca de expirar o ya expiró, Apidog puede actualizarlo automáticamente para que las solicitudes continúen sin reautenticación manual ni copia de un token nuevo.
Esto es especialmente útil para equipos que depuran APIs protegidas por OAuth con frecuencia.
Cómo ayuda durante la depuración
Antes, el flujo podía verse así:
Enviar solicitud
-> token expirado
-> error de autenticación
-> obtener nuevo token
-> copiar token
-> repetir solicitud
Ahora, el flujo puede mantenerse activo:
Enviar solicitud
-> Apidog detecta token por expirar o expirado
-> actualiza el token automáticamente
-> continúa la solicitud
Esto reduce interrupciones de autenticación durante depuración de API, pruebas y validación repetida de solicitudes.
Mejoras basadas en comentarios de usuarios
Mejor compatibilidad con el Cliente MCP
Apidog mejoró la compatibilidad con el Cliente MCP y ahora puede analizar esquemas no estándar de forma más fiable.
Esto ayuda al conectar con servidores o herramientas MCP cuya salida de esquema no sigue estrictamente los formatos esperados.
En lugar de fallar temprano por diferencias de esquema, Apidog puede manejar más respuestas MCP del mundo real y mejorar la tasa de éxito durante integración y depuración de herramientas.
Cuándo usarlo
Este cambio es relevante si:
- Integras herramientas MCP externas.
- Recibes esquemas inconsistentes o no estándar.
- Necesitas depurar respuestas MCP sin bloquearte por diferencias menores de formato.
Buscar pasos estáticos por nombre en suites de pruebas
Al añadir pasos estáticos a una suite de pruebas, ahora puedes buscar por nombre.
Esto acelera la configuración en proyectos con muchos:
- Endpoints.
- Casos de prueba.
- Escenarios.
Flujo recomendado
- Abre la suite de pruebas.
- Añade un paso estático.
- Busca el paso por nombre.
- Selecciona el endpoint, caso de prueba o escenario correcto.
- Guarda la suite.
Este cambio evita navegar manualmente por listas largas y reduce errores al seleccionar pasos similares.
Las tareas programadas añaden una opción “Cada 8 horas”
Las tareas programadas ahora incluyen la opción “Cada 8 horas”.
Esto añade un intervalo útil para:
- Pruebas automatizadas recurrentes.
- Comprobaciones tipo monitoreo.
- Validaciones periódicas de APIs.
- Ejecución de escenarios críticos varias veces al día.
Ejemplo de planificación:
00:00 -> ejecución programada
08:00 -> ejecución programada
16:00 -> ejecución programada
La aplicación web de Apidog soporta configuración de encabezados generados automáticamente
La aplicación web de Apidog ahora soporta la configuración de encabezados generados automáticamente.
Esto da más control sobre el comportamiento de las solicitudes desde el navegador y permite alinear los headers generados con los requisitos del equipo o del proyecto.
Casos donde resulta útil
- APIs con políticas estrictas de encabezados.
- Equipos que necesitan consistencia entre entornos.
- Depuración de solicitudes generadas automáticamente.
- Validación de headers esperados por gateways, proxies o servicios backend.
Corrección de errores y pequeñas mejoras
Este mes también se lanzaron correcciones y mejoras menores:
- Rendimiento mejorado al seleccionar escenarios de prueba grandes para ramas secundarias, reduciendo la posibilidad de errores de tiempo de espera.
- Las listas de ramas de sprint y ramas generales ahora permiten mostrar y copiar los ID de las ramas.
- Se muestra un mensaje más amigable cuando macOS no puede enviar solicitudes a la intranet.
- Se corrigió un problema donde las URL base del servicio no se importaban y los endpoints no se vinculaban al servicio especificado al reimportar datos de Apidog a un nuevo módulo.
- Se corrigió un problema donde la autenticación OAuth 1.0 configurada para añadirse al encabezado de la solicitud no se añadía realmente.
- Se corrigió un problema donde el código de solicitud de endpoint generado no funcionaba correctamente cuando la autenticación básica usaba variables chinas.
- Se corrigió un problema donde el código de solicitud generado usaba incorrectamente HTTPS cuando el endpoint usaba HTTP.
- Se corrigió un problema donde la ejecución de escenarios de CLI podía reportar “Token inesperado” cuando un paso del escenario hacía referencia a un cuerpo de respuesta en formato raw.
- Se corrigió un problema donde los detalles del informe de prueba seguían mostrando “en ejecución” después de que un escenario de prueba automatizado terminara de forma anormal.
- Se corrigió un problema donde el informe correspondiente no se mostraba en la lista de informes de prueba después de ejecutar casos de escenario en la carpeta raíz.
- Se corrigió un problema donde la actualización de la aplicación web de Apidog cambiaba automáticamente el proyecto de vuelta a la rama principal.
- Se corrigió un problema donde las opciones de filtro de etiquetas no tenían contenido durante la importación de ramas y al insertar endpoints en Markdown.
- Se corrigió un problema donde los servicios no predeterminados se añadían repetidamente al importar archivos de Apidog con múltiples módulos y servicios.
- Se corrigió un problema donde las etiquetas de documentos Markdown no se importaban correctamente al importar datos de Apidog.
- Se corrigió un problema donde los conflictos aún se mostraban después de fusionar endpoints en la rama principal en algunos casos.
- Se corrigió un problema donde podían ocurrir errores de frontend en algunos casos al depurar endpoints SSE.
- Se corrigió un problema donde las estadísticas de proyectos locales solo contaban datos del módulo predeterminado.
- Se corrigió un problema donde la importación de un archivo Apidog multimódulo desde la página de detalles del equipo importaba incorrectamente los endpoints al módulo predeterminado.
- Se corrigió un problema donde los cambios desaparecían en algunos casos después de enviar modificaciones.
- Se corrigió un problema donde se mostraba un mensaje de error incorrecto en el flujo de verificación de correo electrónico al cambiar contraseñas.
Qué significa esto para tu equipo
En conjunto, estas actualizaciones hacen que Apidog sea más útil en flujos de trabajo que combinan personas, agentes de IA, especificaciones y pruebas automatizadas.
| Área | Qué mejora | Por qué es importante |
|---|---|---|
| Flujos de trabajo CLI impulsados por IA | La CLI puede ayudar a los agentes de IA a operar con recursos de proyectos reales de Apidog, ejecutar casos de prueba, referenciar activos existentes y controlar las exportaciones con mayor precisión. | Más fácil para los agentes de IA completar tareas de API con contexto estructurado del proyecto en lugar de adivinar a partir de información no estructurada. |
| Importación y exportación | Las importaciones de la API de Postman pueden limpiar nombres de variables y aclarar nombres de espacios de trabajo; la importación/exportación de OpenAPI/Swagger soporta parámetros de tipo objeto y de tipo referencia. | Menos limpieza después de la migración y un intercambio de especificaciones API más completo. |
| Autenticación | Los tokens de OAuth 2.0 pueden actualizarse automáticamente. | Menos interrupciones durante depuración y pruebas de API. |
| Compatibilidad con MCP | El Cliente MCP puede analizar más esquemas no estándar. | Mejor compatibilidad con herramientas y servidores MCP del mundo real. |
| Flujos de trabajo de pruebas | Los pasos estáticos son más fáciles de encontrar, y las tareas programadas soportan un intervalo adicional de 8 horas. | Configuración de suites de pruebas más rápida y ejecución de pruebas recurrentes más flexible. |
| Configuración de la aplicación web | Los encabezados generados automáticamente se pueden configurar en la aplicación web de Apidog. | Mayor control sobre el comportamiento de solicitudes en flujos de trabajo basados en navegador. |
La ruta operativa queda más limpia:
Mejor contexto para agentes de IA
+ importaciones con menos limpieza
+ OAuth 2.0 con menos interrupciones
+ pruebas recurrentes más flexibles
+ mayor control de configuración
= flujos de trabajo API más estables
Únase a la conversación
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) para las últimas actualizaciones.
P.D. Para obtener todos los detalles sobre las actualizaciones, consulte el Changelog de Apidog.
Atentamente,
El Equipo de Apidog
Top comments (0)