Automatisierung und Tests

Sobald eine Anfrage funktioniert, kannst du sie für dich arbeiten lassen. Echo automatisiert wiederkehrende Aufgaben: Tests ausführen, Aufrufe verketten, Abhängigkeiten simulieren und eine API nach Zeitplan prüfen.

Eine ganze Sammlung ausführen

Der Sammlungsrunner führt eine Sammlung von Anfang bis Ende aus:

  1. Wähle die Sammlung und lege die Anzahl der Durchläufe fest.
  2. Füge eine Pause zwischen Anfragen hinzu, wenn die Ziel-API etwas Abstand braucht.
  3. Aktiviere den Abbruch bei Fehlern, wenn ein Fehler den Lauf stoppen soll.
  4. Starte den Lauf und verfolge die Ergebnisse in Echtzeit.

Mit dem Runner kannst du eine API nach einem Deployment prüfen oder einen Fehler über mehrere Durchläufe reproduzieren. Lade eine CSV-Datei mit Spaltenüberschriften oder ein JSON-Array aus Objekten, um die Sammlung mit unterschiedlichen Eingaben auszuführen. Jede Zeile liefert die Werte für einen Durchlauf.

Exportiere anschließend einen JUnit-XML-Bericht für deine Testwerkzeuge oder einen HTML-Bericht zum Lesen und Teilen. Der Verlauf speichert den Namen der Datendatei und ihre Zeilenanzahl, damit du die Vorbereitung eines Laufs nachvollziehen kannst.

Anfragen ohne Code verketten

Anfrageketten sind deklarativ und brauchen keine Skripte. Jede Kette führt Schritte der Reihe nach aus, liest mit JSONPath Werte aus einer Antwort und gibt sie an spätere Schritte weiter. Anmeldung, Token abrufen, Ressource erstellen und prüfen können zu einer einzigen Kette gehören.

Schritte können auch Bedingungen enthalten, damit die Kette je nach tatsächlicher API-Antwort unterschiedliche Wege nimmt.

Wählen, wo dein Mock läuft

Wenn eine echte Abhängigkeit noch nicht bereitsteht, kann das Frontend-Team mit einem Mock weiterarbeiten und Zeitüberschreitungen sowie Fehlercodes testen. Echo erkennt Routen anhand von Pfadmustern, unterstützt statische oder vertragsbasierte Antworten und lässt dich Verzögerung und Status je Route festlegen.

Mocks auf dem Desktop beantworten Anfragen, die du innerhalb von Echo sendest, in jedem Tarif, auch in Free. Für eine URL, die eine andere Anwendung oder Person aufrufen kann, veröffentlichst du einen synchronisierten Mock über den Bereich "Öffentliches Hosting" in Maestro. Das gehört zu Echo Pro und Pro AI; für einen Team-Mock brauchst du zusätzlich die Berechtigung Echo/ManageHosting. Im öffentlichen Dienst antwortet der Mock weiter, ohne dass die Desktop-App läuft. Unter Öffentliches Mock-Hosting findest du die Veröffentlichungsschritte und die Zugriffsregeln.

Für Regeln in deiner eigenen .NET-Anwendung nutzt du Mock.Client oder Mock.Server und einen Anwendungsschlüssel mit ServeMocks. Die Pakete verwenden nicht die öffentliche Mock-URL, ihr Regelfeed gehört aber zum selben bezahlten Echo-Tarif. Vorhandene Regeln im Cache können auch nach einer verweigerten Aktualisierung noch Mock-Antworten liefern.

Desktop-Mocks unterstützen auch gRPC-Antworten und Folgen von WebSocket-Nachrichten. Sie beantworten Anfragen innerhalb von Echo. Sie öffnen keinen Netzwerkport und stellen anderen Anwendungen keine gRPC- oder WebSocket-Adresse bereit. Das öffentliche Mock-Hosting beantwortet HTTP-Anfragen.

Neben Antworten auch Verträge prüfen

Ein Vertrag beschreibt die Datenstruktur, die eine Anwendung bereitstellt oder konsumiert. Veröffentliche Versionen und vergleiche ihre Kompatibilität in der für deine Anwendung relevanten Richtung. Die Pakete Contracts und Testing verbinden Veröffentlichung und Validierung mit .NET-Automatisierung.

Läufe planen

Wähle für jeden Zeitplan den Ausführungsort. Für Desktop-Zeitpläne muss Echo geöffnet bleiben. Gehostete Zeitpläne laufen auf den Servern von Gapfy und werden auch nach dem Schließen der App ausgeführt. Dafür brauchst du einen kostenpflichtigen Echo-Tarif und die Berechtigung für diese Funktion.

Der gehostete Modus unterstützt HTTP-Anfragen sowie die GraphQL-Operationen query und mutation mit mindestens fünf Minuten zwischen den Läufen. Wähle die Umgebung, speichere den Zeitplan und prüfe, ob Echo die Planung auf dem Server bestätigt. Das Synchronisieren eines Desktop-Zeitplans ändert seinen Ausführungsmodus nicht. Maestro zeigt die Ergebnisse gehosteter Zeitpläne und synchronisierte Zusammenfassungen von Sammlungsläufen.

Bei Bedarf Skripte verwenden

Wenn deklarative Ketten nicht ausreichen, unterstützt Echo JavaScript vor und nach der Anfrage mit der bekannten pm.*-API, einschließlich Assertions. Wenn du bereits Postman-Skripte geschrieben hast, ist dir das Vorgehen vertraut: Statuscodes, Antwortkörper und Header prüfen und den Lauf fehlschlagen lassen, wenn das Ergebnis nicht den Erwartungen entspricht.

Beginne mit Ketten, weil sie leichter zu lesen und zu pflegen sind. Nutze Skripte, wenn du eigene Logik brauchst.

Nächste Schritte