Öffentliches Mock-Hosting

Ein im öffentlichen Dienst veröffentlichter 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 Mocks auf dem Desktop ausführen oder im Dienst unter mock.gapfy.io veröffentlichen. Im öffentlichen Dienst antwortet der Mock 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

  • Mocks auf dem Desktop: Echo beantwortet die Anfragen, die du dort selbst sendest. In jedem Echo-Tarif enthalten, auch in Free.
  • Öffentliches Mock-Hosting: Andere Anwendungen erhalten eine direkt aufrufbare URL im öffentlichen Dienst. Das Veröffentlichen gehört zu Echo Pro und Pro AI.
  • Mocks in deiner .NET-Anwendung: Nutze Mock.Client oder Mock.Server mit Regeln, die über einen Anwendungsschlüssel geladen werden. Diese Pakete verwenden nicht die öffentliche URL, brauchen für den Regelfeed aber ebenfalls Echo Pro oder Pro AI.

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 den Bereich "Öffentliches Hosting" des Servers und aktiviere die Veröffentlichung. In Free öffnet sich der Bereich, bietet aber weder Aktivieren noch das Erneuern der öffentlichen Kennung an und erklärt, dass öffentliches Hosting nicht in deinem Tarif enthalten ist. Mocks auf dem Desktop und Verträge bleiben verfügbar. Für das Veröffentlichen brauchst du Echo Pro oder Pro AI; den Tarif kann ein Organisationsadministrator unter Einstellungen > Abrechnung ändern. In einem bezahlten Tarif veröffentlichst du einen Mock deines eigenen Arbeitsbereichs als Eigentümer; für einen Team-Mock brauchst du zusätzlich die Berechtigung Echo/ManageHosting, die der Organisationsadministrator standardmäßig erhält.
  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.

Grenzen der öffentlichen Veröffentlichung

Ein bezahlter Echo-Tarif erlaubt bis zu 25 gleichzeitig veröffentlichte Mocks pro Organisation. Das ist eine feste Grenze: Beim Versuch, einen 26. Mock zu veröffentlichen, wird die Veröffentlichung abgewiesen. Deaktiviere die öffentliche Veröffentlichung eines anderen Mocks, um einen Platz freizugeben. In Free kannst du keinen Mock im öffentlichen Dienst veröffentlichen.

Für den öffentlichen Dienst gilt ein Monatswert von 50.000 bedienten Anfragen pro Platz. Die Nutzung wird auch darüber hinaus gemessen; Antworten werden wegen des Monatswerts nicht verweigert. Unabhängig davon begrenzt der Dienst den Verkehr auf 300 Anfragen pro Minute und Mock; bei Überschreitung kann er mit 429 antworten.

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 Bereich "Öffentliches Hosting" kannst du die Veröffentlichung deaktivieren oder die öffentliche Kennung erneuern und eine neue URL erhalten. Danach musst du die Aufrufer aktualisieren. Plattformbetreiber können das öffentliche Hosting aussetzen oder global sperren. Der Eigentümer kann einen so gesperrten Mock erst nach Aufhebung der Sperre wieder aktivieren. Aktualisiere den Bereich, um den aktuellen Status zu sehen.

Wenn die Organisation nach Ablauf einer etwaigen Kulanzfrist keinen Tarif mit öffentlichem Hosting mehr hat, wird ein bereits veröffentlichter Mock nicht gelöscht. Seine URL und öffentliche Kennung bleiben erhalten, aber Aufrufer erhalten 503 mit dem Fehlercode mock-server-suspended und dem Header Retry-After: 300. Der öffentliche Fehler nennt den Grund nicht; im Maestro erscheint die Meldung, dass öffentliches Hosting im Tarif fehlt. Sobald wieder ein gültiger Tarif besteht, antwortet dieselbe URL ohne erneutes Veröffentlichen. Die Änderung kann in beide Richtungen bis zu etwa fünf Minuten dauern. Eine vom Betreiber gesetzte Sperre für einen Mock hebt nur ein Betreiber auf. Ein Notfallschalter für die Plattform oder eine Organisation kann dagegen zu seinem festgelegten Zeitpunkt ablaufen.

Lade die Regeln in deine Anwendung

Anwendungen und Schlüssel erklärt den Scope ServeMocks für den .NET-Regelfeed. Wähle diesen Weg, wenn deine Anwendung mit Echo-Regeln Anfragen beantworten oder abfangen soll, statt die öffentliche Mock-URL aufzurufen. Auch dieser Weg braucht Echo Pro oder Pro AI.