Comment créer une extension pour votre spécification Open API »wiki utile par Allen Helton | Meilleure programmation | Janv.2021

Online Coding Courses for Kids

photo par Photos gratuites de Pixabay.

Pour utiliser des variables dynamiques, nous devons savoir quand enregistrer et consommer leur.

Sauvegarde des variables dynamiques

Pour enregistrer une variable à partir d’un test dynamique, nous devons savoir quand et où récupérer la valeur d’une réponse. Dans notre exemple, certains codes de réponse sur des points de terminaison spécifiques produiront les valeurs souhaitées.

Il y a deux éléments de données que nous devons identifier: le nom de la variable et où la trouver. Nous devons également informer notre gestionnaire que nous voulons enregistrer une variable.

Dans cet esprit, le schéma suivant répond à nos besoins commerciaux:

x-postman-variables: 
- type: save
name: myVariable
path: .id

Avec ce schéma, type indiquera au gestionnaire que nous voulons enregistrer la variable. name va être le nom de la variable dans Postman. path va être le chemin JSON de la propriété dans la réponse. Vous pouvez voir que nous avons également fait de l’extension un tableau au cas où nous aurions besoin de stocker plusieurs valeurs à partir d’une seule réponse.

Nous pouvons maintenant ajouter l’extension dans notre spécification Open API sous une réponse spécifique pour un point de terminaison particulier. Nous pouvons référencer le Gopher Holes Unlimited exemple de spécification d’API.

Exemple d’utilisation de l’extension dans l’OAS Gopher Holes Unlimited

Consommer des variables dynamiques

Maintenant que nos variables sont correctement sauvegardées, tout se résume à les utiliser dans les tests suivants. Avec Open API Spec, nous sommes en mesure de définir les paramètres utilisés dans nos requêtes.

Puisque nous voulons utiliser une variable dans les demandes ultérieures, nous devons nous assurer d’enrichir notre OAS parameters avec l’extension. Chaque fois que nous utilisons le paramètre, le générateur de test extrait la valeur de la variable Postman actuelle et l’utilise dans le test.

Il est beaucoup plus facile de consommer les valeurs que de les enregistrer car nous avons juste besoin de connaître le nom de la variable. Cela nous amène au schéma suivant:

x-postman-variables: 
- type: load
name: myVariable

Avec ce schéma, type dit que nous chargeons la valeur et name indique à notre gestionnaire quelle variable nous voulons. Avec cela, nous avons défini notre définition d’extension!

L’ajout de l’exemple dans notre OEA ressemblera à ceci:

Exemple d’utilisation de la consommation d’une variable dans Gopher Holes Unlimited

Close Menu