Erste Schritte

Mit Echo bereitest du eine API-Anfrage vor, sendest sie und prüfst die Antwort. Dieser Leitfaden behandelt Windows und macOS. Für Android und iOS beginne mit Echo auf dem Smartphone.

Echo installieren

Suche unter Windows im Microsoft Store nach Gapfy Echo, installiere die App und öffne sie über das Startmenü. Auf einem Mac mit Apple silicon lädst du das Installationspaket herunter, öffnest die .pkg-Datei und schließt die Installation ab. Öffne Echo anschließend unter Programme. Dieser Download ist für Macs mit Apple-Chip einschließlich kompatibler iMac-Modelle gedacht; er installiert keine Intel-Version.

Den Einstieg wählen

Im Gastmodus speicherst du Anfragen, Sammlungen und Umgebungen ohne Konto auf deinem Rechner. Die Datenbank ist verschlüsselt; Windows DPAPI oder macOS Keychain schützt ihren Schlüssel. Gespeicherte Arbeit kannst du ohne Verbindung bearbeiten. Ein Aufruf einer entfernten API benötigt weiterhin Zugang zu dieser API.

Melde dich über deinen üblichen Browser an, um Arbeit zu synchronisieren, geteilte Sammlungen zu verwenden und eine Organisation auszuwählen. Prüfe den aktiven Arbeitsbereich, bevor du gemeinsame Inhalte erstellst. Cloud-Funktionen hängen von den Berechtigungen und dem Tarif deines Kontos ab. Siehe Sammlungen und Freigaben.

Die erste Anfrage senden und speichern

  1. Erstelle einen Bereich für dein Projekt und darin eine Sammlung.
  2. Füge eine HTTP-Anfrage mit einem erkennbaren Namen hinzu, etwa List orders.
  3. Wähle die Methode und trage die API-URL ein. Ergänze Abfrageparameter und Header in den Editoren. Für POST oder PUT wählst du das erwartete Body-Format.
  4. Richte die Authentifizierung der Anfrage ein, falls erforderlich. Verwende möglichst eine Umgebungsvariable, statt ein Token in die URL zu kopieren.
  5. Wähle die Umgebung und sende die Anfrage. Eine laufende Ausführung kannst du abbrechen.
  6. Prüfe Status, Header und Antwortinhalt. Die Zeitansicht trennt Verbindungsaufbau, Warten auf den Server und Herunterladen der Antwort.
  7. Speichere die Anfrage in der Sammlung. Ein Verlaufseintrag ersetzt keine gespeicherte Anfrage, die du weiter pflegen möchtest.

Beginne mit einer Leseoperation auf einer API, die du sicher aufrufen kannst. Eine Anfrage kann Daten anlegen oder ändern. Die einzelnen Editoren erklärt Anfragen und Protokolle.

Den Arbeitsplatz anpassen

Mit der Befehlspalette findest du Aktionen, ohne alle Menüs zu durchsuchen. Öffne Anfragen in Tabs oder verteile sie auf bis zu vier Bereiche, um zusammengehörige Aufrufe zu vergleichen. Im Verlauf findest du frühere Ausführungen und ihre Details über Filter wieder.

Die Einstellungen bieten helles, dunkles und Systemdesign, Akzentfarben und sieben Oberflächensprachen. Die Website hat sechs Sprachen. Starte Echo neu, wenn der Sprachwechsel es verlangt. Im Bereich für Tastenkürzel kannst du Belegungen ändern und auf ihre Vorgaben zurücksetzen.

Die Einstellungen steuern auch das Wiederherstellen von Tabs und Vorgaben für neue Anfragen, etwa Zeitlimit, Zertifikatsprüfung und Weiterleitungen. Prüfe die einzelne Anfrage, wenn du eine Ausnahme brauchst. Proxy und Clientzertifikate beschreibt Anfragen und Protokolle.

Vorhandene Anfragen übernehmen

Nutze den Importbereich in den Einstellungen für Postman-, Insomnia-, Bruno- oder OpenAPI-Dateien. Der separate cURL-Importassistent nutzt KI und erfordert eine Pro-AI-Lizenz. Lies Vorschau und Hinweise vor dem Bestätigen. Einige Einstellungen und Anhänge musst du manuell anpassen. Import und Export erklärt auch verknüpfte Ordner und die Veröffentlichung von Dokumentation.

Wenn etwas nicht funktioniert

Prüfe bei einer fehlgeschlagenen Anfrage Umgebung, aufgelöste URL, Authentifizierung und Antwortdetails. Fehlen geteilte Inhalte, prüfe Konto, Arbeitsbereich und Synchronisierungsstatus. Die Details zeigen letzte Aktivitäten und Aktionen für Konflikte oder reparaturbedürftige Einträge.

Die Einstellungen zeigen Version, Diagnosewerkzeuge und Updateprüfungen, soweit der Installationskanal sie unterstützt. Eine nicht verfügbare Prüfung in der App bedeutet nicht, dass eine Store-Installation keine Updates hat. Notiere für den Support die Version und die fehlgeschlagene Aktion und entferne Zugangsdaten aus geteilten Protokollen.

Das Zurücksetzen der Gerätedatenbank entfernt die Daten auf diesem Gerät. Exportiere noch nicht synchronisierte Arbeit, bevor du diese Wiederherstellungsmaßnahme erwägst. Bei üblichen Verbindungs- oder Berechtigungsfehlern beginne mit den Fehlerdetails.

Weiterarbeiten