Anfragen und Protokolle

Echo vereint fünf Protokolle in einem Editor, damit du nicht mehr das Werkzeug wechseln musst, sobald eine API mehr als einfaches HTTP verwendet.

Die fünf Protokolle

  • HTTP: der Editor für alltägliche Anfragen mit Methode, Headern, Body und Authentifizierung je Anfrage.
  • gRPC: echter, auf Reflection basierender Transport. Echo erkennt Dienste direkt auf dem Server und unterstützt unäre Aufrufe sowie alle Streaming-Modi.
  • GraphQL: Introspektion, Variablen und Abonnements.
  • WebSocket: interaktiv verbinden und Nachrichten senden, mit einer Hexadezimalansicht für Binärframes.
  • SSE: vom Server gesendete Ereignisströme abonnieren, mit automatischer Wiederverbindung bei einem Abbruch des Streams.

Du wählst das Protokoll beim Erstellen einer Anfrage aus, und der Editor passt sich daran an.

Authentifizierung

Die Authentifizierung wird je Anfrage konfiguriert und von übergeordneten Sammlungen geerbt. Lege Bearer, Basic, einen API-Schlüssel oder OAuth2 client credentials einmal für eine Sammlung fest. Jede enthaltene Anfrage verwendet diese Konfiguration, sofern sie sie nicht durch eine eigene ersetzt.

Tokens für OAuth2 client credentials werden zwischengespeichert. Wiederholtes Senden handelt daher nicht jedes Mal einen neuen Token aus.

Antworten lesen

Die Antwortanzeige zeigt Status, Header und Body jedes Aufrufs. Zwei Begleiter helfen dir bei der Arbeit über längere Zeit:

  • Der Anfrageverlauf bewahrt frühere Aufrufe auf und lässt sich filtern. So findest du die fehlgeschlagene Anfrage von gestern schnell wieder.
  • Der Cookie-Speicher zeichnet Cookies auf und enthält einen Editor. Das hilft, wenn du eine Sitzung von Hand prüfen oder anpassen musst.

Aufschlüsselung der Netzwerkzeiten

Jede Antwort enthält eine Aufschlüsselung der Netzwerkzeiten: DNS, TCP, TLS, Zeit bis zum ersten Byte und Download. Aus "die API fühlt sich langsam an" wird damit eine konkrete Antwort darauf, wo die Zeit tatsächlich verbraucht wurde.

Echo hält außerdem eine Vergleichsbasis für deine Anfragen fest und zeigt den Hinweis "langsamer als gewöhnlich", wenn ein Aufruf dahinter zurückbleibt. So fällt eine Regression auf, bevor jemand ein Ticket erstellt.

Effizient arbeiten

Einige Gewohnheiten lohnen sich von Anfang an:

  1. Öffne die geteilte Ansicht, um mit bis zu 4 Bereichen nebeneinander zu arbeiten, etwa mit einer Anfrage, ihrem gRPC-Gegenstück und zwei Referenzaufrufen.
  2. Nutze die Befehlspalette, um überallhin zu springen, ohne die Hände von der Tastatur zu nehmen.
  3. Belege Tastenkürzel neu, damit sie zu deinen Gewohnheiten aus anderen Werkzeugen passen.

Nächste Schritte

  • Keine Hostnamen und Tokens mehr fest codieren: /docs/echo/environments-and-variables
  • Dieselbe Anfrage gleichzeitig an mehrere Umgebungen senden: /docs/echo/environments-and-variables
  • Anfragen in automatisierte Prüfungen verwandeln: /docs/echo/automation