Apidog Docs
🇪🇸 Español
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇪🇸 Español
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇪🇸 Español
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. Suite de pruebas
  • Centro de aprendizaje de Apidog
  • Primeros pasos
    • Introducción a Apidog
    • Conceptos básicos en Apidog
    • Navegación por Apidog
    • Inicio rápido
      • Descripción general
      • Crear un Endpoint
      • Realizar una petición
      • Añadir una aserción
      • Creación de escenarios de prueba
      • Compartir documentación de API
      • Explore Más
    • Migración a Apidog
      • Descripción general
      • Importación manual
      • Importación programada (Vincular fuentes de datos)
      • Opciones de importación
      • Exportar datos
      • Importar desde
        • Importar desde Postman
        • Importar especificación OpenAPI
        • Importar cURL
        • Importar archivos Markdown
        • Importar desde Insomnia
        • Importar desde apiDoc
        • Importar archivo .har
        • Importar WSDL
  • Datos de API mock
    • Descripción general
    • Smart Mock
    • Mock personalizado
    • Secuencia de prioridad de mock
    • Scripts de mock
    • Mock en la nube
    • Mock de Runner autoalojado
    • Idioma de mock (locales)
  • Cuenta y preferencias
    • Configuración de la cuenta
    • Generación de un token de acceso OpenAPI
    • Notificación
    • Configuración de idioma
    • Teclas de acceso rápido
    • Configuración del proxy de red
    • Copia de seguridad de los datos
    • Actualizar Apidog
    • Eliminar cuenta
    • Funciones experimentales
  • Enviar peticiones
    • Descripción general
    • Depuración de SSE
    • Cliente MCP
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP o WebService
    • GraphQL
    • gRPC
    • Usar agentes proxy de petición para la depuración
    • Crear peticiones
      • Historial de peticiones
      • Conceptos básicos de las peticiones
      • Parámetros y cuerpo
      • Encabezados de petición
      • Configuración de peticiones
      • Depurar peticiones
      • Guardar peticiones como endpoints
      • HTTP/2
    • Autenticación y autorización
      • Descripción general
      • Certificados de CA y de cliente
      • Tipos de autorización
      • Autenticación Digest
      • OAuth 1.0
      • OAuth 2.0
      • Autenticación Hawk
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Respuesta y cookies
      • Visualización de respuestas de API
      • Gestión de cookies
      • Descripción general
  • Desarrollar y depurar APIs
    • Descripción general
    • Generación de peticiones
    • Envío de peticiones
    • Casos de depuración
    • Casos de prueba
    • Valores dinámicos
    • Validación de respuestas
    • Diseño primero vs. petición primero
    • Generación de código
    • Entornos y variables
      • Descripción general
      • Uso de variables
      • Gestión de entornos
    • Secretos de la bóveda
      • Descripción general
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • Módulos de valores dinámicos
      • Aerolínea
      • Animal
      • Color
      • Comercio
      • Empresa
      • Base de datos
      • Tipo de dato
      • Fecha
      • Finanzas
      • Comida
      • Git
      • Hacker
      • Helpers
      • Imagen
      • Internet
      • Ubicación
      • Lorem
      • Música
      • Número
      • Persona
      • Teléfono
      • Ciencia
      • String
      • Sistema
      • Vehículo
      • Word
    • Preprocesadores y postprocesadores
      • Descripción general
      • Aserción
      • Extraer variable
      • Esperar
      • Seguridad
      • Operaciones de base de datos
        • Descripción general
        • MySQL
        • MongoDB
        • Redis
        • Cliente Oracle
      • Uso de scripts
        • Descripción general
        • Scripts de preprocesador
        • Scripts de posprocesador
        • Scripts públicos
        • Referencia de scripts de Postman
        • Llamar a otros lenguajes de programación
        • Uso de bibliotecas JS
        • Visualización de respuestas
        • Ejemplos de scripts
          • Scripts de aserción
          • Uso de variables
          • Modificación de peticiones
          • Otros ejemplos
    • Depuración de APIs
      • Depurador de agentes de IA
      • Depurador A2A
  • Diseñar APIs
    • Descripción general
    • Crear un nuevo proyecto de API
    • Conceptos básicos de endpoints
    • Directrices de diseño de API
    • Módulo
    • Configurar múltiples ejemplos de cuerpo de petición
    • Componentes
    • Campos comunes
    • Parámetros globales
    • Historial de cambios del endpoint
    • Comentarios
    • Gestión de endpoints por lotes
    • API de protocolo personalizado
    • Modo Spec-first (Beta)
    • Esquemas de seguridad
      • Descripción general
      • Crear un esquema de seguridad
      • Usar el esquema de seguridad
      • Esquema de seguridad en la documentación en línea
    • Funciones avanzadas
      • Campos personalizados de endpoint
      • Escenarios de prueba asociados
      • Estado del endpoint
      • Apariencia de las listas de parámetros
      • Identificación única de endpoints
    • Schemas
      • Descripción general
      • Crear un nuevo esquema
      • Crear un esquema
      • Generar esquemas a partir de JSON, etc.
      • oneOf, allOf, anyOf
      • Uso de Discriminator
  • Pruebas de API
    • Descripción general
    • Escenarios de prueba
      • Crear un escenario de prueba
      • Pasar datos entre peticiones
      • Condiciones de control de flujo
      • Sincronizar datos desde endpoints y casos de endpoint
      • Importar endpoints y casos de endpoint desde otros proyectos
      • Exportar escenarios de prueba
    • Informes de prueba
      • Informes de prueba
    • Ejecutar escenarios de prueba
      • Ejecutar un escenario de prueba
      • Ejecutar escenarios de prueba por lotes
      • Pruebas basadas en datos
      • Datos de prueba compartidos
      • Tareas programadas
      • Gestionar el entorno de ejecución de API de otros proyectos
    • Suite de pruebas
      • Descripción general
      • Crear una suite de pruebas
      • Orquestar suite de pruebas
      • Ejecutar conjuntos de pruebas localmente
      • Ejecutar suites de prueba mediante CLI
      • Tareas programadas
    • Probar APIs
      • Pruebas de integración
      • Pruebas de rendimiento
      • Pruebas de extremo a extremo
      • Pruebas de regresión
      • Pruebas de contrato
    • Apidog CLI
      • Descripción general
      • Instalación y ejecución de Apidog CLI
      • Opciones de Apidog CLI
    • CI/CD
      • Descripción general
      • Integrar con Github Actions
      • Integrar con Gitlab
      • Integrar con Jenkins
      • Activar prueba mediante commit de Git
  • Publicar documentación de API
    • Descripción general
    • Tecnologías de API compatibles
    • Uso compartido rápido
    • Visualización de la documentación de API
    • Documentación de Markdown
    • Publicación de sitios de documentación
    • Página de inicio de sesión personalizada
    • Diseños personalizados
    • CSS, JavaScript, HTML personalizados
    • Dominio personalizado
    • Funciones de IA
    • Configuración de SEO
    • Configuración avanzada
      • Búsqueda en la documentación
      • Proxy CORS
      • Integración de Google Analytics
      • Configuración del árbol de carpetas
      • Configuración de visibilidad
      • Incrustación de valores en las URL de documentación
    • Versiones de API
      • Descripción general
      • Crear versiones de API
      • Publicación de versiones de API
      • Compartir endpoints con versiones de API
  • Ramas
    • Descripción general
    • Crear una rama de sprint
    • Prueba de APIs en una rama
    • Diseño de API en una rama
    • Fusionar ramas de sprint
    • Gestión de ramas de sprint
    • AI Branch (Beta)
  • Funciones de IA
    • Descripción general
    • Habilitación de funciones de IA
    • Generación de casos de prueba
    • Modificación de esquemas con IA
    • Comprobación de cumplimiento del endpoint
    • Comprobación de integridad de la documentación de API
    • Nomenclatura de campos con IA
    • Preguntas frecuentes
  • Servidor MCP de Apidog
    • Descripción general
    • Conectar un proyecto de Apidog a la IA
    • Conectar documentación publicada a la IA
    • Conectar archivos OpenAPI a la IA
  • Mejores prácticas
    • Gestión de firmas de API
    • Acceso a APIs protegidas con OAuth 2.0
    • Flujo de trabajo de colaboración
    • Gestión del estado de autenticación
  • Espacio sin conexión
    • Descripción general
  • Administración
    • Gestión de proyectos
      • Gestión de proyectos
      • Configuración de notificaciones
      • Gestión de miembros del proyecto
      • Recursos del proyecto
        • Conexión a la base de datos
        • Conexión con Git
    • Gestión de equipos
      • Gestión de equipos
      • Gestión de miembros del equipo
      • Actividades del equipo
      • Roles y permisos del equipo
      • Recursos del equipo
        • General Runner
        • Variables de equipo
        • Agente proxy de peticiones
      • Colaboraciones en tiempo real
        • Colaboración en equipo
    • Lista de verificación de incorporación
      • Conceptos básicos
      • Guía de incorporación
    • Gestión de la organización
      • Gestión de la organización
      • Rol y permisos de la organización
      • Gestión de planes
        • Administradores de facturación en organizaciones
      • Inicio de sesión único (SSO)
        • Descripción general de SSO
        • Configuración de Microsoft Entra ID
        • Configuración de Okta
        • Configuración de SSO para una organización
        • Gestión de cuentas de usuario
        • Asignar grupos a equipos
      • Aprovisionamiento SCIM
        • Introducción al aprovisionamiento SCIM
        • Microsoft Entra ID
        • Okta
      • Recursos de la organización
        • Runner autohospedado
  • Facturación
    • Descripción general
    • Créditos
    • Actualizar su plan
    • Métodos de pago alternativos
    • Gestión de suscripciones
    • Trasladar equipos de pago a organizaciones
  • Complementos
    • API Hub
    • Plugin Apidog Intellij IDEA
    • Extensión del navegador
      • Chrome
      • Microsoft Edge
    • Proxy de peticiones
      • Proxy de peticiones en la web
      • Proxy de petición en documentos compartidos
      • Proxy de peticiones en el cliente
  • Datos y seguridad
    • Almacenamiento y seguridad de datos
    • Privacidad y seguridad de los datos del usuario
    • Enrutamiento de peticiones y seguridad de datos
  • Referencias
    • Enfoque de diseño de API primero
    • Extensiones de la especificación OpenAPI de Apidog
    • JSONPath
    • XPath
    • Expresiones regulares
    • JSON Schema
    • Formato de archivo CSV
    • Instalación del entorno Java
    • Entorno de implementación de Runner
    • Sintaxis Markdown de Apidog
    • Extensiones Swagger de Apidog
      • Descripción general
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Extensiones JSON Schema de Apidog
      • Descripción general
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • Apidog Europa
    • Apidog Europe
  • Centro de soporte
  1. Suite de pruebas

Orquestar suite de pruebas

Después de crear una suite de pruebas, debe añadir contenido de prueba. Apidog proporciona modos flexibles "Estático" y "Dinámico" para satisfacer distintas necesidades de gestión de pruebas.

Importar contenido de prueba#

En la página de detalles de la suite de pruebas, bajo la pestaña Orchestration, haga clic en + Add Endpoint Test Case o + Add Test Scenario. En la ventana emergente de selección, puede alternar entre el modo Static o Dynamic.
imagen.png

1. Modo estático#

El modo estático se utiliza para especificar con precisión los elementos de prueba que se ejecutarán.
🎯 Lógica principal
El sistema registra los ID de los casos de prueba específicos que usted selecciona. Incluso si se añaden nuevos casos de prueba a la categoría de origen, el alcance de ejecución de esta suite no cambiará, lo que garantiza la controlabilidad de los resultados de la prueba.
🚀 Mejores escenarios de uso
Verificación de corrección de errores (Hotfix): Seleccione entre 3 y 5 casos de prueba estrechamente relacionados con el error, forme un "paquete de verificación" y verifique rápidamente el resultado de la corrección, sin perder tiempo ejecutando casos no relacionados.
Estabilización del negocio principal (Core Path): Para procesos extremadamente esenciales y estables, como "pedido-pago". No queremos que se activen alertas de supervisión porque una persona recién incorporada añadió accidentalmente un caso de prueba incompleto.
Pruebas de compatibilidad con versiones antiguas: Seleccione un lote de casos de prueba de endpoints antiguos específicamente para verificar la compatibilidad de clientes de versiones antiguas.
⚠️ Características de mantenimiento
Alto coste de mantenimiento: Si es necesario incluir nuevos casos en esta prueba especializada, deben añadirse manualmente.

2. Modo dinámico#

El modo dinámico se utiliza para filtrar automáticamente, mediante reglas, los elementos de prueba que se ejecutarán.
🎯 Lógica principal
El sistema guarda "Reglas de filtro" (Scope & Filter). Cada vez que se ejecuta, el sistema escanea todo el proyecto en tiempo real e incluye en el plan de ejecución todos los casos más recientes que cumplen los criterios.
🚀 Mejores escenarios de uso
Prueba de regresión a nivel de módulo: Establezca la carpeta "Trading Center" como carpeta de origen. Los evaluadores solo necesitan escribir nuevos casos en la carpeta, y la suite los incluirá automáticamente al ejecutarse.
Prueba de humo: Cree una suite dinámica con la regla Priority = P0. Ejecútela antes de cada lanzamiento para cubrir automáticamente todos los casos clave marcados como P0.
Verificación de iteración de versión: Utilice la función de etiquetas, establezca la regla en Tag = v2.5.0. Una vez finalizado el desarrollo, ejecute esta suite para verificar todas las nuevas funciones de esta versión.
⚠️ Características de mantenimiento
Coste de mantenimiento cero: Una vez configuradas las reglas, no es necesario mantener posteriormente la suite en sí; solo deben mantenerse los atributos de los casos (ubicación, etiquetas, prioridad).

Ajustar el orden de ejecución#

El contenido importado se mostrará en una lista, y usted puede arrastrar los elementos de la lista para ajustar el orden de ejecución.
Para los elementos añadidos "estáticamente", puede utilizar Edit para eliminar casos de prueba individualmente o eliminar todo el grupo.
imagen.png
Para los grupos añadidos "dinámicamente", solo puede eliminar todo el grupo o editar los criterios de filtro, y no puede eliminar elementos individuales dentro del grupo.
imagen.png

Configuración avanzada#

En el lado derecho de la página de diseño de la suite de pruebas, puede expandir Advanced Config para tener un control más granular sobre cómo se ejecuta la suite de pruebas.
imagen.png
imagen.png

Entorno#

Definición: De forma predeterminada, hereda el entorno de ejecución ya establecido en la suite de pruebas. Si se especifica un entorno aquí, esa configuración de entorno tendrá prioridad durante la ejecución.
Caso de uso: Adecuado para escenarios en los que necesita reutilizar el mismo conjunto de pasos de prueba en diferentes entornos.

Datos de prueba#

Se utiliza para especificar si se deben usar datos de prueba durante la ejecución.
Sin datos de prueba: Los pasos de prueba se ejecutan solo una vez, sin ejecutar pruebas basadas en datos.
Usar datos de prueba: Ejecute varias veces en función de los datos de prueba; se usa comúnmente para pruebas parametrizadas.

En caso de error#

Configure cómo debe gestionar la prueba los errores, que pueden incluir fallos de aserción, fallos de validación de formato de datos, excepciones de petición de endpoint, errores del servidor, etc.
Ignorar: Continúe ejecutando los pasos posteriores cuando se produzca un error, sin interrumpir la ejecución actual.
Continuar: Cuando se produzca un error, omita los pasos restantes de la ronda actual y pase directamente a la siguiente ronda de ejecución.
Finalizar ejecución: Termine inmediatamente los pasos posteriores en cuanto se produzca un error.

Iteraciones#

Definición: El número de veces que cada hilo recorre todos los pasos.
Caso de uso: Se utiliza comúnmente para escenarios de verificación de estabilidad o pruebas de estrés simples.

Retraso#

Definición: Establezca cuántos milisegundos (ms) se debe esperar después de que se complete cada paso de prueba antes de ejecutar el siguiente paso.
Caso de uso: Evita activar mecanismos de limitación de tasa o de disyuntor en el servidor de destino debido a una alta frecuencia de peticiones, lo que garantiza una ejecución fluida de la prueba.

Guardar peticiones/respuestas#

Definición: Controle si el informe de prueba incluye datos detallados de peticiones y respuestas (como Header, Body, etc.).
Opciones:
Todo: Guarde los detalles completos de todos los pasos, independientemente de si se superaron o fallaron. Gran volumen de datos, adecuado para depuración profunda.
Solo fallidos: Guarde únicamente los detalles de los pasos que fallaron durante la ejecución. Recomendado; ahorra espacio de almacenamiento y facilita la identificación rápida de las razones del fallo.
No guardar: No guarde ningún detalle; registre únicamente el estado de aprobado/fallido y la duración.

Valores de variables de entorno/globales#

Los valores de variables de entorno/globales especifican qué valores reales se deben usar para las variables de entorno/globales en este escenario de prueba. Hay dos opciones. La información detallada puede verse aquí. Al elegir usar valores de variables guardados en Runner, se le pedirá que seleccione adicionalmente el alcance de variables que se usará.
El propósito de este alcance es ayudar a los usuarios a separar mejor las variables según las necesidades reales, evitando situaciones en las que la ejecución de una tarea programada provoque que otras tareas fallen debido a cambios en las variables. Después de seleccionar el alcance, también puede ver los valores de las variables dentro de este alcance a través de la entrada que aparece en la interfaz del producto.
Alcance de variables en RunnerLeer/escribir variables de entorno/globalesDescripción
Compartir solo en el escenario de prueba actual
  • En el Runner especificado actual, este escenario de prueba tiene un archivo dedicado para almacenar de forma persistente sus variables de entorno/globales.
  • Solo el escenario de prueba actual puede leer y escribir variables en este archivo.
El alcance de variables más pequeño, con un impacto mínimo. Adecuado para casos en los que los resultados de la ejecución anterior de este escenario de prueba deben usarse en la siguiente ejecución.
Los archivos de variables para escenarios de prueba, tareas y carpetas de tareas se guardan todos en la ruta del contenedor de Runner /opt/runner/variables.
Compartir entre todos los escenarios de prueba de la tarea programada actual
  • En el Runner especificado actual, la tarea programada tiene un archivo para almacenar variables de entorno/globales que pueden usarse entre todos sus escenarios de prueba.
  • Todos los escenarios de prueba de la tarea programada actual pueden leer y escribir variables en este archivo.
Un alcance de variables recomendado con impacto moderado. Adecuado para casos en los que es necesario compartir datos entre distintos escenarios de prueba dentro de la misma tarea programada.
Compartir entre todas las tareas programadas de la carpeta de tareas programadas actual
  • En el Runner especificado actual, la carpeta de tareas programadas tiene un archivo para almacenar variables de entorno/globales que pueden usarse entre todas sus tareas programadas y escenarios de prueba.
  • Todos los escenarios de prueba de todas las tareas programadas dentro de la carpeta actual pueden leer y escribir variables en este archivo.
El alcance de variables más grande, con el impacto más significativo. Es posible que la ejecución de una determinada tarea programada modifique el valor de una variable, lo que provocaría el fallo de otras tareas programadas. Adecuado cuando es necesario compartir datos entre varias tareas de la misma carpeta.
Modified at 2026-06-09 08:52:14
Previous
Crear una suite de pruebas
Next
Ejecutar conjuntos de pruebas localmente
Built with