Remote-Mocks

Ein Remote-Mock gibt deinem Team einen HTTP-Endpunkt, bevor die echte Abhängigkeit bereitsteht. Nutze ihn für die Frontend-Entwicklung, gemeinsame Demos oder gezielte Fehler- und Verzögerungsszenarien. Echo kann einen Mock lokal auf dem Desktop ausführen oder im Dienst unter mock.gapfy.io hosten. Ein gehosteter Mock antwortet auch bei geschlossener Desktop-App.

Lokale Mocks fangen Anfragen aus Echo selbst ab. Sie öffnen keinen HTTP-Server für andere Anwendungen.

Wähle den Ausführungsort

  • Lokaler Desktop: Anfragen bleiben während der Erstellung und beim Experimentieren auf deinem Rechner.
  • Gehosteter Mock: Ein anderer Rechner erhält eine direkt aufrufbare URL.
  • In deiner .NET-Anwendung: Nutze Mock.Client oder Mock.Server mit Regeln, die über einen Anwendungsschlüssel geladen werden. Dieser Weg ist von der öffentlichen Hosting-URL getrennt.

Veröffentliche deinen ersten Mock

  1. Öffne Mocks in Maestro und wähle den Arbeitsbereich, dem der Mock gehört.
  2. Erstelle einen Server und eine Route mit HTTP-Methode, Pfadmuster, Status und Antwort. Wähle eine statische Antwort oder einen Vertrag. Du kannst auch einen auf dem Desktop gespeicherten und synchronisierten Mock verwenden.
  3. Öffne das Hosting-Panel des Servers und aktiviere öffentliches Hosting. Dafür brauchst du die vom Panel akzeptierten Administratorrechte im Arbeitsbereich.
  4. Kopiere die dort angezeigte vollständige Basis-URL und ergänze den Routenpfad. Der Hostname allein ist kein Mock-Endpunkt.
  5. Rufe die Route aus der konsumierenden Anwendung auf und prüfe die Antwort einschließlich X-Echo-Mock.

Mit Verträgen erzeugst du strukturierte Antworten und verwaltest Versionen. Statische Antworten eignen sich, wenn du einen exakten Antworttext brauchst.

Teile bewusst

Jeder, der die öffentliche URL kennt, kann ihre Routen aufrufen. Sie ist nicht durch einen eck_-Anwendungsschlüssel geschützt. Verwende erfundene Daten, halte Zugangsdaten aus Antworttexten und Headern heraus und teile die URL nur mit den vorgesehenen Personen.

Im Hosting-Panel kannst du das Hosting deaktivieren oder die öffentliche Kennung erneuern und eine neue URL erhalten. Danach musst du die Aufrufer aktualisieren. Plattformbetreiber können Hosting aussetzen oder global sperren. Der Eigentümer kann einen gesperrten Mock erst nach Aufhebung der Sperre aktivieren. Aktualisiere das Panel, um den aktuellen Status zu sehen.

Lade die Regeln in deine Anwendung

Anwendungen und Schlüssel erklärt die separate Berechtigung ServeMocks für den .NET-Regelfeed. Wähle diesen Weg, wenn deine Anwendung mit Echo-Regeln Anfragen beantworten oder abfangen soll, statt die gehostete URL aufzurufen.