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.

So kannst du eine API nach einem Deployment schnell prüfen oder einen sporadischen Fehler über mehrere Durchläufe reproduzieren.

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.

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

Mit cron geplante Läufe prüfen die API, während Echo läuft. Lege den Zeitplan fest und Echo benachrichtigt dich bei einem Fehler, damit du einen defekten Endpunkt vor deinen Nutzern entdecken kannst. Zeitpläne werden zwischen deinen angemeldeten Geräten synchronisiert. Dadurch werden sie jedoch nicht zu gehosteten Jobs.

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