Dans l'introduction au Monitoring multi-étapes, nous avons indiqué que les assertions vous permettent de définir des vérifications à appliquer au contenu de vos réponses HTTP; elles aident à surveiller le comportement correct et les limites de performance de vos API. Cette section décrit en détail comment définir les assertions.

Chaque assertion est définie de la façon suivante :

Source property comparison target value

par exemple :

Response body as JSON Products[0].Price Is greater than 100

  • La source de l'assertion : ce champ définit l'attribut de la réponse HTTP que vous voulez vérifier. Chaque option disponible est décrite dans cet article.
  • La propriété de l'assertion : certaines options de la source de l'assertion (en particulier la vérification du contenu et les options liées à l'en-tête) vous obligent à spécifier le contenu ou l'en-tête à vérifier. Ceci est expliqué plus en détail ici pour chaque type de source.
  • La comparaison de l'assertion : ce champ exprime le type de vérification que nous devons effectuer. Par défaut, nous ferons une comparaison de type X est égal à Y, mais il y a beaucoup plus d'options de comparaison pour le texte et les chiffres. Voir la liste des options de comparaison.
  • La valeur cible de l'assertion : pour la plupart des assertions, vous devez effectuer une comparaison avec une certaine valeur que vous spécifiez. Il s'agit de la valeur cible. En fonction de la source de l'assertion que vous utilisez et le type de comparaison que vous effectuez, cette valeur peut être du texte, un nombre ou même un booléen (vrai ou faux). Vous pouvez également utiliser une référence à une variable qui représente l'une de ces valeurs.

Que se passe-t-il si une condition d'assertion n'est pas remplie ?

Toutes les assertions d'une étape sont exécutées dès que la requête HTTP a été exécutée et que la réponse a été traitée. En règle générale, toutes les assertions pour l'étape sont évaluées, même si une des assertions ne passe pas. Cela signifie qu'il est possible que plusieurs assertions puissent signaler un échec pour une étape.

Si une ou plusieurs assertions échouent, l'exécution du moniteur s'arrête à la fin de l'étape en cours. Les étapes suivantes ne seront pas exécutées et la vérification du moniteur signalera une erreur. Le code d'erreur et la description dépendent du type d'échec. Si plusieurs assertions échouent, le premier qui échoue est considéré comme le plus important.