Deine erste Anfrage

Diese Seite führt dich von einem leeren Echolot zu einer gesendeten Anfrage und einer gelesenen Antwort. Sie nutzt die Demo-API unter https://demo.echolot.dev, einen fiktiven Outdoor-Shop, der ohne jede Einrichtung antwortet.

1. Arbeitsbereich anlegenCopy Anchor Link

Ein Arbeitsbereich ist ein Ordner, der deine Anfragen enthält, jeweils eine Datei. Lege zuerst einen an.

Der Arbeitsbereich öffnet sich in einem eigenen Fenster. Er ist leer, daher steht auf der Seite Dieser Arbeitsbereich ist leer.

2. Anfrage anlegenCopy Anchor Link

https://demo.echolot.dev/v1/products?category=tents&per_page=5

Du musst nichts sichern. Echolot schreibt die Anfrage einen Moment, nachdem du aufgehört hast zu tippen, in eine .req.toml-Datei im Ordner des Arbeitsbereichs, und unter dem Namen des Arbeitsbereichs unten in der Seitenleiste steht Alles gesichert.

3. Anfrage sendenCopy Anchor Link

Drücke ⌘R oder wähle Senden. Auch ⌘↩ sendet. Solange die Anfrage läuft, wird aus Senden der Knopf Abbrechen (⌘.).

4. Antwort lesenCopy Anchor Link

Der Antwortbereich liegt neben der Anfrage (oder darunter, wenn du das Layout „Untereinander“ wählst).

• Die Zeile über der Antwort zeigt den Status (200 OK), die Zeit und die Größe. Halte den Zeiger darauf, um die Details zu sehen: die Größen, die Zeit jeder Phase (DNS, Connect, TLS, Waiting, Transfer), die TLS-Verbindung und alle Weiterleitungen.
• Body zeigt den Body. Mit den Optionen unter Ansicht darüber wechselst du die Darstellung: Text, JSON (formatiert), JSON-Baum und bei anderen Inhalten XML, Formular, MessagePack oder Vorschau. Echolot wählt die erste anhand des Content-Types. Mit ⌘F suchst du Text im Body.
• Header listet die Header der Antwort. Die Demo-API legt die Gesamtzahl in X-Total-Count und die nächsten Seiten in Link ab.
• Cookies listet die Cookies, die die Antwort gesetzt hat.
• Roh und Hex zeigen die Bytes, wie sie empfangen wurden. Übertragung zeigt den ganzen Austausch, wie er über das Netzwerk ging, gesendet und empfangen.
• Tests zeigt die Ergebnisse der Prüfungen der Anfrage, sobald sie welche hat.

Jede Antwort bleibt außerdem im Verlauf der Anfrage (⌘Y), sodass du zu ihr zurückkehren und sie mit der nächsten vergleichen kannst.

5. Prüfung hinzufügenCopy Anchor Link

Prüfungen laufen nach jedem Senden und sagen dir, wenn eine API nicht mehr so antwortet, wie sie soll.

1. Öffne den Tab Tests der Anfrage.
2. Wähle Aus Antwort erzeugen …. Echolot schlägt anhand der Antwort, die du gerade erhalten hast, Prüfungen vor: den Status, den Content-Type, Werte im JSON.
3. Hake die gewünschten an und wähle N Tests hinzufügen (der Knopf zählt die Prüfungen, die du angehakt hast).
4. Sende erneut. Der Tab Tests der Antwort zeigt jede Prüfung als bestanden oder fehlgeschlagen.

Skripte und Tests behandelt jede Art von Prüfung.

Nächste SchritteCopy Anchor Link

• Sende einen Body: Lege eine weitere Anfrage an, stelle die Methode auf POST, die Adresse auf https://demo.echolot.dev/echo/anything und tippe auf dem Tab Body etwas JSON. Die Demo schickt zurück, was sie bekommen hat.
• Kopiere die Anfrage mit Anfrage › Als cURL kopieren (⌥⌘C) als cURL-Befehl oder erzeuge mit Anfrage › Code erzeugen … (⌥⌘G) Code dafür.
• Lege die Serveradresse in eine Variable und füge Umgebungen hinzu: Umgebungen.
• Finde dich zurecht: Das Fenster.
• Folge einer längeren Anleitung: Dein erster Arbeitsbereich.