Las pruebas de contrato se utilizan para validar si la respuesta real de la API se ajusta a la especificación definida en la documentación de la API (OpenAPI). Al realizar comprobaciones de coherencia sobre contenido como el código de estado y la estructura de la respuesta, permiten descubrir oportunamente incoherencias entre la implementación y la documentación durante las fases de desarrollo, depuración y pruebas, lo que garantiza un comportamiento de API estable y fiable entre servicios.La capacidad de validación de respuestas (prueba de contrato) de Apidog está profundamente integrada con la documentación de la API. Puede utilizarse durante peticiones de API, en casos de depuración, casos de prueba y pasos de pruebas automatizadas. Es una función fundamental que está habilitada de forma predeterminada.Habilitar la validación de respuestas#
La validación de respuestas puede habilitarse por módulo y utilizarse en diferentes etapas según las necesidades del negocio. El interruptor correspondiente se encuentra en "Settings -> Response Validation Settings".Peticiones de API y casos de depuración#
Cuando está habilitada, la función "Validate Response" está disponible en las vistas "Request" y "Debug Case" dentro del módulo APIs, y se utiliza para verificar la coherencia de las respuestas durante la fase de depuración.Casos de prueba#
Cuando está habilitada, "Validate Response" puede ejecutarse en "Test Cases" dentro del módulo APIs para verificar el comportamiento de la API durante las pruebas manuales.Pasos de pruebas automatizadas#
Cuando está habilitada, "Validate Response" puede añadirse como un paso de prueba en el módulo Tests, incorporando la validación de respuestas al flujo de trabajo completo de pruebas automatizadas.Validar el contenido de la respuesta#
La validación de respuestas de Apidog realizará automáticamente las siguientes comprobaciones en función de la especificación OpenAPI definida en la documentación de la API:Validar el código de estado HTTP de la respuesta#
Comprueba si el código de estado HTTP de la respuesta real es coherente con el código de estado definido en la documentación. Por ejemplo:La documentación define 200, pero la devolución real es 204
La documentación define múltiples valores posibles (por ejemplo, 200, 201, 400, 403), validando contra el rango permitido
Validar el esquema del cuerpo de la respuesta#
Valida el siguiente contenido en función del esquema de datos definido en la documentación:Si un campo es obligatorio
Si el valor de un campo es null
Si el tipo de campo es correcto
Si los campos obligatorios están presentes
Si la estructura de Arrays y Objects se ajusta a la documentación
Si los valores enum son válidos
Control de propiedades adicionales en objetos#
Para campos de tipo Object:Si additionalProperties no está establecido en la documentación, puede elegir si desea permitir que la respuesta real contenga campos adicionales no definidos en la documentación.
Si additionalProperties está establecido, valida la autorización de campos adicionales de acuerdo con las reglas de la documentación.
Modified at 2026-06-09 08:52:14
