Requêtes et protocoles
Créez une requête, choisissez son protocole et indiquez l'adresse à appeler. Echo conserve la requête, sa réponse et son historique ensemble. Enregistrez les appels utiles dans une collection pour les relancer ou les intégrer à un test.
Envoyer une requête HTTP
Choisissez la méthode, puis ajoutez les paramètres de requête et les en-têtes. Chaque ligne peut être activée ou désactivée sans être supprimée. Le corps accepte du texte, du JSON, du XML, des formulaires URL-encoded, des formulaires multipart avec fichiers et un fichier binaire. Le formatage facilite la lecture des longs corps JSON et XML.
Utilisez {{baseUrl}}/orders pour éviter de répéter le nom du serveur. Les variables fonctionnent aussi dans les en-têtes, les valeurs du corps et l'authentification. Consultez environnements et variables.
Les réglages de la requête contrôlent le délai maximal, les redirections et leur nombre maximal, l'encodage de l'URL, la validation TLS et l'utilisation des cookies enregistrés. L'option de conservation de la méthode garde méthode et corps sur les redirections 301 et 302 ; 303 passe toujours à GET. Gardez la validation des certificats activée en usage normal.
Configurer l'authentification
Configurez chaque requête et utilisez des variables pour réutiliser les identifiants.
| Méthode | Informations nécessaires |
|---|---|
| Bearer | Jeton d'accès |
| Basic | Identifiant et mot de passe |
| API key | Nom, valeur et emplacement dans un en-tête ou la requête |
| OAuth2 client credentials | URL du jeton, client ID, client secret et scope |
| OAuth2 authorization code avec PKCE | URLs d'autorisation et de jeton, client ID, URI de redirection et scope ou audience requis |
| AWS Signature V4 | Access key, secret key, région, service et session token facultatif |
| Digest ou NTLM | Identifiants exigés par le serveur ; NTLM accepte aussi un domaine |
| Hawk | Identifiant de la clé, clé et algorithme |
Les jetons client credentials sont réutilisés entre les appels tant qu'ils restent valides. Authorization code ouvre le navigateur et exige une session interactive ainsi qu'une URI de redirection enregistrée auprès du fournisseur d'identité de l'API.
L'option d'authentification héritée ne résout pas encore une configuration modifiable de la collection parente. Configurez l'authentification sur la requête. Lors d'un import Postman, l'authentification héritée compatible est copiée dans les requêtes importées.
Appeler un service gRPC
Indiquez le serveur, lancez la découverte des services et sélectionnez une méthode. La découverte utilise la réflexion du serveur. Si elle est indisponible, vous pouvez joindre un fichier .proto contenant les définitions nécessaires à l'appel.
Rédigez le message en JSON. Unary et server streaming attendent un objet. Client streaming et streaming bidirectionnel attendent un tableau, par exemple [{"name":"first"},{"name":"second"}]. Echo envoie les messages dans l'ordre et affiche les messages reçus dans la vue du flux. Utilisez Arrêter pour terminer un appel en cours.
Explorer GraphQL
Rédigez une query ou mutation, fournissez les variables en JSON et indiquez le nom de l'opération si nécessaire. L'introspection charge le schema pour consulter les champs et insérer des modèles de query, mutation ou subscription. Si le serveur désactive l'introspection, vous pouvez saisir l'opération vous-même.
Pour les subscriptions, activez ce mode et utilisez l'adresse ws:// ou wss:// du service. Consultez les événements dans la vue du flux. Vérifiez aussi le champ errors : un statut HTTP 200 peut accompagner une erreur GraphQL.
Utiliser WebSocket et SSE
Une requête WebSocket ouvre la connexion et permet d'envoyer d'autres messages tant qu'elle reste active. Choisissez texte ou binaire ; la saisie binaire accepte des octets hexadécimaux tels que DE AD BE EF. La vue présente les trames envoyées et reçues et permet de filtrer ou d'effacer la liste affichée.
SSE reçoit les événements du serveur. La reconnexion automatique peut utiliser le délai conseillé par le serveur et l'identifiant du dernier événement. Les réglages permettent de la désactiver et d'ajuster le délai d'inactivité de WebSocket et SSE. Arrêtez la connexion une fois les événements nécessaires recueillis.
Lire une réponse
Consultez statut, en-têtes, corps, cookies et résultats des tests. La console de scripts aide à comprendre les assertions en échec. L'historique permet de rouvrir une réponse, une comparaison ou une exécution de collection. Vous pouvez aussi transformer une réponse HTTP enregistrée en route de mock après avoir vérifié son contenu.
Le panneau des temps affiche les mesures disponibles : DNS, connexion, TLS, premier octet et téléchargement. Une connexion réutilisée ne produit pas forcément de nouvelle mesure à chaque étape. Avec assez d'appels enregistrés réussis, Echo compare la durée à l'historique et peut signaler une réponse plus lente. Réglez le seuil en pourcentage dans les paramètres. Cette comparaison ne remplace pas un test de charge.
Cookies, proxy et certificats client
Le gestionnaire de cookies permet de consulter, modifier et supprimer les cookies de l'hôte actuel, de les effacer pour cet hôte ou d'importer un en-tête Cookie. Désactivez leur utilisation sur la requête pour tester sans session enregistrée.
Les réglages avancés proposent les modes proxy système, désactivé et manuel, avec identifiants et règles d'exclusion. Pour TLS mutuel, associez un motif d'hôte à un certificat PFX ou à l'empreinte d'un certificat du magasin système. Ces réglages et chemins de fichiers appartiennent à l'appareil ; configurez-les sur chaque machine exécutant les requêtes.
Utilisez le mode de comparaison pour comparer les environnements ou l'automatisation pour répéter les appels avec des vérifications.