Aserciones

¿Qué son las aserciones?

Una aserción es una condición que debe cumplir la respuesta de tu API. Añades una o más aserciones a una verificación y, cuando alguna no se cumple, la verificación se marca como fallida y se dispara una alerta.

Tipos de aserciones

Status code: compara el código de estado HTTP de la respuesta con un número, por ejemplo Equals 200 o Less than 400.
Response time: compara el tiempo de respuesta total, en milisegundos, con un número, por ejemplo Less than 800.
Body: comprueba que el cuerpo de la respuesta contiene (Contains) o no contiene (Does not contain) un texto. La coincidencia es una subcadena literal que distingue mayúsculas de minúsculas; no se admiten expresiones regulares y un valor vacío siempre falla.

Para código de estado y tiempo de respuesta puedes elegir Equals, Not equals, Equals or Greater than, Equals or Less than, Greater than o Less than.

Cómo añadir una aserción

En el formulario de la verificación, busca la sección Aserciones y haz clic en Agregar Aserción.
Elige el tipo (Status code, Response time o Body).
Elige la comparación y escribe el Valor.
Guarda la verificación.

Aserciones fallidas y detalles de la verificación

Cuando una aserción falla, la página de detalles de la verificación muestra cuál falló, para que veas por qué la verificación se marcó como fallida.

Interacción con los límites de tiempo de respuesta

Si una verificación es más lenta que su límite de tiempo de respuesta, se marca como degradada. Si además tiene una aserción que falla, la verificación se marca como fallida.

Casos de uso prácticos

Rendimiento: una aserción Response time con Less than fija un techo estricto para tu API.
Detección de errores: una aserción Status code detecta errores inesperados.
Contenido: una aserción Body confirma que la respuesta sigue conteniendo el valor que esperas, por ejemplo el nombre de un campo o una palabra clave.

Las verificaciones multipaso admiten las mismas aserciones en cada paso, consulta Verificaciones de API multipaso.