Requêtes et protocoles

Echo réunit cinq protocoles dans un même éditeur, pour que vous n'ayez plus à changer d'outil dès qu'une API ne se limite pas à HTTP.

Les cinq protocoles

  • HTTP : l'éditeur de requêtes du quotidien, avec méthode, en-têtes, corps et authentification par requête.
  • gRPC : un véritable transport fondé sur la réflexion. Echo découvre les services directement depuis le serveur et prend en charge les appels unaires ainsi que tous les modes de streaming.
  • GraphQL : introspection, variables et abonnements.
  • WebSocket : connexion et envoi interactif de messages, avec une vue hexadécimale pour les trames non textuelles.
  • SSE : abonnement aux flux d'événements envoyés par le serveur, avec reconnexion automatique lorsque le flux est interrompu.

Vous choisissez le protocole lors de la création d'une requête et l'éditeur s'y adapte.

Authentification

L'authentification se configure par requête et peut être héritée des collections parentes. Définissez Bearer, Basic, une clé d'API ou OAuth2 client credentials une fois sur une collection : chaque requête qu'elle contient utilisera cette configuration, sauf si elle la remplace par la sienne.

Les jetons OAuth2 client credentials sont mis en cache. Des envois répétés ne renégocient donc pas un jeton à chaque fois.

Lire les réponses

L'affichage de la réponse présente le statut, les en-têtes et le corps de chaque appel. Deux outils vous aident à travailler dans la durée :

  • L'historique des requêtes conserve vos appels précédents et permet de les filtrer. La requête en échec d'hier est ainsi facile à retrouver.
  • Le gestionnaire de cookies les enregistre et comprend un éditeur, utile pour inspecter ou ajuster manuellement une session.

Détail des temps réseau

Chaque réponse comprend le détail des temps réseau : DNS, TCP, TLS, temps jusqu'au premier octet et téléchargement. Cela transforme l'impression que "l'API semble lente" en un diagnostic concret de l'étape qui a réellement pris du temps.

Echo conserve aussi une référence pour vos requêtes et affiche un indicateur "plus lente que d'habitude" lorsqu'un appel prend du retard. Une régression ressort ainsi avant même l'ouverture d'un ticket.

Gagner en efficacité

Quelques habitudes méritent d'être prises tôt :

  1. Ouvrez la vue divisée pour travailler avec jusqu'à 4 panneaux côte à côte, par exemple une requête, son équivalent gRPC et deux appels de référence.
  2. Utilisez la palette de commandes pour aller partout sans quitter le clavier.
  3. Réattribuez les raccourcis pour retrouver vos habitudes acquises dans d'autres outils.

Étapes suivantes

  • N'inscrivez plus les noms d'hôte et les jetons en dur : /docs/echo/environments-and-variables
  • Exécutez la même requête dans plusieurs environnements à la fois : /docs/echo/environments-and-variables
  • Transformez les requêtes en vérifications automatisées : /docs/echo/automation