Apportez votre aide…
Bruno
Bruno est un logiciel (client) qui permet de tester des API REST et de mémoriser les requêtes avec les paramètres associées telle que les paramètres de questionnement, le token (JWT) d'accès pour les requêtes POST
Depuis la version 3.0, Bruno supporte OpenCollection pour décrire les collections/requêtes, dans des fichiers YAML au lieu des fichiers .bru précédemment utilisés !
Versionner les collections
Bruno a l'avantage d'enregistrer les collections et les requêtes sous forme de fichiers YAML, cela permet de facilement versionner ces fichiers et de les partager. Lors de la création d'une collection, il est important de bien définir le répertoire sont sauvegarder les fichiers de cette collection.
Protéger les clés/mots de passe
Du fait du versionnement, se pose la question de comment ne pas versionner les clés(JWT) et autres mots de passe. Il y a plusieurs solutions, dont celle de créer un fichier .env dans le répertoire de la collection, d'y mettre les secrets et dans les paramètres de la requête, au lieu de la valeur, de mettre
{{process.env.nom-de-la-clé-dans-le-fichier-env}}
Documenter
On peut documenter les collections, il suffit d'éditer la partie Documentation de chaque collection
On peut aussi documenter chaque requêtes d'une collection en saisissant le texte dans l'onglet Docs
Générer le code d'une requête
À partir d'une requête, on peut cliquer sur l'icone </> à droite de la barre de l'URL de la requête, puis dans la fenêtre Generate Code qui s'ouvre, sélectionner le language (Shell, JavaScript, Python…) et éventuellement la méthode (boutons à côté de la liste de choix), par exemple pour JavaScript : fetch, axios…
Problèmes rencontrés
Lorsqu'on veut définir le chemin d'une collection, Bruno ouvre la fenêtre de l'explorateur d'Ubuntu (Files, nemo…) et on peut se retrouver avec des caractères illisibles.
La solution 1) consiste à vider le cache des polices de caractères :
sudo rm /var/cache/fontconfig/* rm ~/.cache/fontconfig/* fc-cache -r