Apidog: API mocken ohne Code schreiben

Ihr Frontend-Team ist blockiert. Das Backend für GET /users und GET /orders ist noch nicht bereit, aber die Benutzeroberfläche benötigt realistische Daten, um Listen darzustellen, Paginierung zu handhaben und leere Zustände zu verwalten. Die alte Lösung besteht darin, eine gefälschte JSON-Datei manuell zu erstellen und zu servieren und diese dann bei jeder Feldänderung zu aktualisieren. Diese Arbeit ist langweilig und gerät fast sofort mit der echten API außer Kontrolle.

Es gibt einen schnelleren Weg. Wenn Sie bereits eine API-Spezifikation haben, kann Apidog direkt aus dem Endpunktschema einen funktionierenden Mock generieren, ohne Konfiguration und ohne Code. Diese Funktion wird Smart Mock genannt, und sie liest Ihre Feldnamen und -typen, um Daten zu erzeugen, die real aussehen: Ein name-Feld gibt einen plausiblen Namen zurück, ein email-Feld eine plausible E-Mail. Dieser Leitfaden führt Sie durch das End-to-End-Mocking zweier E-Commerce-Endpunkte, zeigt Ihnen, wo die Mock-URL zu finden ist, erklärt die Prioritätsreihenfolge, die entscheidet, welche Antwort gewinnt, und behandelt, was zu tun ist, wenn Smart Mock falsch liegt. Wenn Sie zuerst eine umfassendere Einführung in das Konzept wünschen, bereitet unser Überblick über was API-Mocking ist und wie es funktioniert die Bühne, und die JSON Schema-Website erklärt das Constraint-Modell, das Smart Mock respektiert.

Was Smart Mock leistet und warum es Ihnen Zeit spart

Die Mock-Engine von Apidog kann laut Dokumentation fünf Dinge tun. Sie kann automatisch generierte Daten aus Ihrer API-Spezifikation zurückgeben, was Smart Mock ist. Sie kann das von Ihnen in der Spezifikation definierte Antwortbeispiel zurückgeben. Sie kann eine bestimmte benutzerdefinierte Antwort zurückgeben. Sie kann verschiedene Antworten basierend auf Anfrageparametern zurückgeben, was bedingtes Mocking ist. Und sie kann Antworten zurückgeben, deren Werte sich über Mock-Skripte auf die Anfrage beziehen.

Smart Mock ist das „Zero-Config“-Mitglied dieser Familie und ist in Apidog zusammen mit den Design-, Debug- und Testwerkzeugen integriert. Sie definieren keine Beispiel-Bodies und schreiben keine Regeln. Solange ein Endpunkt ein spezifiziertes Antwortschema hat, liest Smart Mock dieses Schema und füllt jedes Feld mit realistischen Werten. Es fungiert als automatischer Fallback: Jeder Endpunkt, der kein vordefiniertes Beispiel hat, gibt immer noch etwas Sinnvolles zurück, sodass keine Anfrage leer zurückkommt.

Für ein blockiertes Frontend ist das der ganze Trick. Sie importieren oder entwerfen Ihre API einmal, und jeder Endpunkt wird in derselben Minute zu einem Live-Mock. Wenn sich das Schema ändert, ändert sich der Mock mit, da beide aus derselben Quelle lesen.

Bevor Sie beginnen: die einzige Anforderung

Smart Mock benötigt eine spezifizierte Antwort am Endpunkt. Das ist die einzige Voraussetzung. Wenn Sie die API in Apidog entworfen haben, fügen Sie ein Antwortschema unter der Antwortdefinition des Endpunkts hinzu. Wenn Sie eine OpenAPI-Datei importiert haben, werden die Antwortschemas normalerweise mitgeliefert. Ohne eine definierte Antwort gibt es nichts, was die Engine lesen könnte, und der Mock gibt nichts Nützliches zurück.

Sie benötigen außerdem den Apidog-Desktop-Client, wenn Sie Local Mock verwenden möchten, da dieser auf Ihrem eigenen Computer läuft und in Apidog Web nicht verfügbar ist. Laden Sie Apidog herunter, um mitzumachen. Es ist kostenlos und es ist keine Kreditkarte erforderlich.

Schritt für Schritt: Mock von GET /users und GET /orders

Lassen Sie uns einen Mock für eine kleine Store-API erstellen. Wir werden zwei Endpunkte definieren und beide aufrufen.

Schritt 1: Definieren Sie die Endpunkte und ihre Antwortschemas

Erstellen Sie GET /users mit einem Antwort-Body wie diesem:

{
  "id": 1024,
  "name": "Amara Osei",
  "email": "amara.osei@example.com",
  "phone": "+1-415-555-0148",
  "createdAt": "2026-03-11T09:24:00Z",
  "isActive": true
}

Erstellen Sie dann GET /orders, das eine Liste zurückgibt:

[
  {
    "orderId": "ORD-58210",
    "userId": 1024,
    "total": 84.50,
    "currency": "USD",
    "status": "shipped",
    "createdAt": "2026-05-02T14:03:00Z"
  }
]

Stellen Sie sicher, dass jede Eigenschaft einen Typ im Schema hat. Typen und Namen sind das, was Smart Mock verwendet, um gute Werte auszuwählen.

Schritt 2: Die Mock-URL finden und kopieren

Jeder Endpunkt erhält automatisch eine Mock-URL. Wo Sie diese finden, hängt vom Modus ab, in dem Sie sich befinden:

• Im DESIGN-Modus befindet sich die Mock-URL im API-Tab unter dem Endpunkt.
• Im DEBUG-Modus befindet sie sich im Mock-Tab.

Klicken Sie auf „Kopieren“, um sie zu übernehmen. Eine Anmerkung: Dies kopiert nur die URL. Wenn Ihr Endpunkt eine andere Methode als GET verwendet oder einen Anfrage-Body benötigt, fügen Sie die Methode und den Body selbst hinzu, wenn Sie ihn aufrufen.

Eine lokale Mock-URL läuft auf 127.0.0.1 Port 4523 und sieht im Pfadmodus so aus:

http://127.0.0.1:4523/m1/{projectID}-{versionNo}-{serverNo}/users

Local Mock startet automatisch, während der Apidog-Client geöffnet ist. Es gibt auch eine ID-Modus-Form, die einen Endpunkt über seine ID anspricht:

http://127.0.0.1:4523/m2/{projectID}-{versionNo}-{serverNo}/{endpointId}

Schritt 3: Den Mock aufrufen

Rufen Sie die URL mit curl auf:

curl http://127.0.0.1:4523/m1/1234567-0-0/users

Sie erhalten etwas Ähnliches zurück, generiert aus Ihrem Schema:

{
  "id": 3187,
  "name": "Diego Marchetti",
  "email": "diego.marchetti@example.net",
  "phone": "+1-628-555-0113",
  "createdAt": "2026-01-27T18:41:22Z",
  "isActive": true
}

Beachten Sie, dass der name wie ein Name und die email wie eine E-Mail aussieht. Das ist Property Name Matching in Aktion, keine zufälligen Daten. Aktualisieren Sie die Anfrage, und die dynamischen Werte werden neu generiert, sodass jeder Aufruf Ihnen neue Daten liefert. Das ist nützlich, um zu testen, wie Ihre Benutzeroberfläche mit unterschiedlichen Inhalten umgeht.

Rufen Sie den Bestell-Endpunkt auf die gleiche Weise auf:

curl http://127.0.0.1:4523/m1/1234567-0-0/orders

Sie erhalten ein Array von Bestellobjekten mit realistischen Gesamtsummen, Status und Zeitstempeln, bereit für Ihre Bestellübersicht.

Wie Smart Mock jeden Wert bestimmt

Wenn Smart Mock eine einzelne Eigenschaft füllt, arbeitet es mit einer dreistufigen Priorität der Datengenerierung. Wenn Sie diese Reihenfolge verstehen, wissen Sie genau, wie Sie die Ausgabe steuern können.

1. Mock-Feld. Wenn Sie einen benutzerdefinierten Wert oder Ausdruck für die Eigenschaft in der Antwortspezifikation festlegen, hat dieser Vorrang. Das Mock-Feld akzeptiert zwei Eingabetypen: einen festen Wert (Fixed value), der jedes Mal als statischer Wert zurückgegeben wird, und eine Faker-Anweisung (Faker statement), die ein dynamischer Ausdruck ist, der variierte Daten erzeugt. Setzen Sie beispielsweise das Mock-Feld eines status-Feldes auf eine Faker-Anweisung, die aus shipped, pending und delivered wählt.
2. Eigenschaftsnamen-Matching. Wenn kein Mock-Feld festgelegt ist, gleicht Smart Mock den Eigenschaftsnamen mit integrierten Regeln unter Verwendung von Wildcard- oder regulären Ausdrucksmustern ab und generiert dann passende Daten. Deshalb werden email und createdAt richtig ausgegeben. Die Regeln befinden sich unter den Mock-Einstellungen, und Sie können Ihre eigenen hinzufügen.
3. JSON-Schema. Wenn der Name keiner Regel entspricht, greift Smart Mock auf einen typbasierten Standard zurück, der durch Ihr Schema eingeschränkt ist. Ein String ohne passenden Namen und ohne Einschränkungen erhält einfach einen generischen String.

Generierte Daten respektieren durchweg Ihre JSON-Schema-Constraints: Stringlänge, Enum-Werte, Zahlenbereiche und Array-Länge werden alle berücksichtigt. Wenn Sie status als Enum mit drei Werten festlegen, gibt Smart Mock immer nur einen dieser drei zurück. Wenn Sie minItems eines Arrays auf 3 setzen, erhalten Sie mindestens drei Elemente zurück. Jede Eigenschaftseinstellung erscheint in den endgültigen Mock-Daten.

Apidog unterstützt auch Mock-Locales, sodass Sie Testdaten in verschiedenen Sprachen und regionalen Formaten generieren können. Wenn Ihr Shop einen japanischen Markt bedient, wechseln Sie die Locale, und Namen und Adressen werden im richtigen Format zurückgegeben.

Wenn Smart Mock falsch liegt und wie Sie es korrigieren können

Smart Mock ist eine Inferenzmaschine, daher liegt es manchmal daneben. Eine Eigenschaft namens sku stimmt möglicherweise mit keiner integrierten Regel überein und greift auf einen generischen String zurück. Ein total könnte als einfache Zahl zurückkommen, obwohl Sie zwei Dezimalstellen und einen sinnvollen Bereich wollten. Hier erfahren Sie, wie Sie dies korrigieren können, von der leichtesten Berührung bis zur größten Kontrolle.

Schema zuerst straffen. Oft ist die Lösung eine bessere Einschränkung. Fügen Sie ein enum zu status, ein minimum und maximum zu total oder ein pattern zu sku hinzu. Smart Mock respektiert all dies, sodass die Ausgabe ohne benutzerdefinierte Werte in den Bereich passt.

Legen Sie ein Mock-Feld fest. Wenn das Schema allein nicht ausdrücken kann, was Sie wollen, legen Sie das Mock-Feld der Eigenschaft fest. Verwenden Sie einen festen Wert (Fixed value), wenn das Feld immer dasselbe zurückgeben soll, wie eine currency von USD. Verwenden Sie eine Faker-Anweisung (Faker statement), wenn Sie Vielfalt innerhalb von Grenzen wünschen. Die Faker-Schicht von Apidog basiert auf den gleichen Ideen wie die Mock.js-Bibliothek, und unser Leitfaden zur Verwendung von Faker in Apidog behandelt die Ausdruckssyntax ausführlich.

Fügen Sie eine Eigenschaftsnamen-Matching-Regel hinzu. Wenn dasselbe falsch benannte Feld in vielen Endpunkten auftaucht, bringen Sie Smart Mock dies einmal bei. Gehen Sie zu Einstellungen, dann Allgemeine Einstellungen, dann Feature-Einstellungen, dann Mock-Einstellungen. Klicken Sie auf Neu, definieren Sie die Bedingung, die Ihrem Feldnamen entspricht, und geben Sie einen Mock-Ausdruck an. Von da an generiert jedes sku im gesamten Projekt das von Ihnen definierte Muster anstelle eines generischen Strings.

Die Mock-Prioritätsreihenfolge: Was wirklich gewinnt

Eine häufige Quelle der Verwirrung ist, welche Antwort ein Endpunkt zurückgibt, wenn mehrere möglich sind. Apidog löst dies mit der Einstellung „Default mock method“ (Standard-Mock-Methode), die Sie in den Projekteinstellungen unter Mock-Einstellungen finden. Es gibt zwei Optionen:

• Smart Mock zuerst (Standard) gibt die Reihenfolge vor: Mock Expectation, dann Smart Mock.
• Antwortbeispiel zuerst gibt die Reihenfolge vor: Mock Expectation, dann Antwortbeispiel, dann Smart Mock.

Lesen Sie diese von links nach rechts. Standardmäßig prüft eine Anfrage auf eine passende Mock Expectation, und wenn keine übereinstimmt, generiert Smart Mock den Body. Wenn Sie zu „Antwortbeispiel zuerst“ wechseln, wird ein definiertes Antwortbeispiel geprüft, bevor Smart Mock zurückfällt.

Eine Regel steht über beiden Sequenzen: Mock Expectations haben immer die höchste Priorität, wenn sie konfiguriert sind und ihre Bedingungen übereinstimmen, unabhängig davon, welche Sequenz Sie gewählt haben. Wenn Sie also eine bedingte Antwort einrichten, die einen 404 zurückgibt, wenn userId 9999 ist, wird diese Erwartung unabhängig von der Standard-Mock-Methode ausgelöst. Eine vollständige Anleitung zu parametergesteuerten Antworten finden Sie in unserem Leitfaden zum Mocking bedingter API-Antworten in Apidog.

Die praktische Zusammenfassung: Benutzerdefinierte Mock Expectations schlagen alles, dann kommt entweder Smart Mock oder das Antwortbeispiel, abhängig von Ihrer Einstellung. Smart Mock ist immer der letzte Fallback, weshalb jede Anfrage eine Antwort erhält.

Local, Cloud und Runner Mock: Wo der Mock läuft

Smart Mock und Custom Mock beschreiben, wie eine Antwort generiert wird. Wo dieser Mock gehostet wird, ist eine separate Wahl, und Apidog bietet Ihnen drei Optionen:

• Local Mock läuft auf Ihrem Computer über den Apidog-Client. Es startet automatisch und ist nur erreichbar, solange der Client geöffnet ist. Es hört auf 127.0.0.1:4523, sodass Sie für ein anderes Gerät in Ihrem Netzwerk die LAN-IP Ihres Rechners benötigen. Es ist in Apidog Web nicht verfügbar.
• Cloud Mock wird auf den Servern von Apidog gehostet und ist 24/7 erreichbar. Es ist standardmäßig ausgeschaltet. Schalten Sie es daher im Umgebungsmanagement ein, wenn ein Teamkollege oder eine bereitgestellte Vorschau den Mock erreichen soll. Die URLs verwenden https://mock.apidog.com mit derselben m1/m2-Pfadstruktur und sind für Tests gedacht, nicht für Produktionsverkehr.
• Runner Mock wird selbst auf Ihrer eigenen Teaminfrastruktur gehostet und teamübergreifend geteilt, was für eine interne Umgebung geeignet ist, in der der Mock hinter Ihrem eigenen Netzwerk leben sollte.

Wählen Sie Local Mock für Solo-Frontend-Arbeiten, Cloud Mock, wenn andere es erreichen müssen, und Runner Mock, wenn der Mock auf Ihren eigenen Servern liegen soll. Wenn Sie gehostete Optionen mit anderen Diensten vergleichen, stellt unser Vergleich von Online-API-Mocking-Tools sie nebeneinander, und der Apidog Cloud Mock-Leitfaden behandelt die gehostete Einrichtung im Detail.

Einige Wissenswerte Fallstricke beim Routing

Mock-Routing hat ein paar Regeln, die Leute stolpern lassen.

Endpunktpfade müssen mit einem / beginnen. Ein Pfad wie /orders wird korrekt durch die Mock-Umgebung geleitet. Eine vollständige URL, die nicht mit / beginnt, wird die Mock-Umgebung überhaupt nicht verwenden, und ein Pfad ohne führenden Schrägstrich funktioniert nur im ID-Modus.

Wenn zwei APIs dieselbe Methode und denselben Pfad teilen, kann der Pfadmodus sie allein nicht unterscheiden. Fügen Sie einen Abfrageparameter ?apidogApiId={endpointId} hinzu, um auf den genauen Endpunkt zu verweisen, den Sie meinen.

Und denken Sie an das Aktualisierungsverhalten: Mock-Daten werden aktualisiert, wenn Sie die Anfrage aktualisieren. Jede Aktualisierung generiert die dynamischen Werte neu. Wenn Sie also zweimal dieselbe Antwort sehen, betrachten Sie wahrscheinlich eine gecachte Ansicht und keinen frischen Aufruf.

Automatisieren Sie den Workflow mit der Apidog CLI

Mocking selbst ist eine GUI- und Cloud-Funktion in Apidog. Die Mock-Engine, sei es Local, Cloud oder Runner, liefert die Antworten; die Apidog CLI hostet oder startet keinen Mock-Server vom Terminal aus. Was die CLI jedoch hinzufügt, ist eine Möglichkeit, das Schema hinter Ihren Mocks korrekt zu halten, während sich das Projekt entwickelt.

Da Smart Mock seine Ausgabe aus dem Endpunktschema generiert, ist der Mock nur so gut wie die Spezifikation. Die Apidog CLI und KI-Codierungsagenten wie Cursor, Claude Code, Trae und Codex, die über sie arbeiten, können die Endpunkte und Schemas in Ihrem Projekt erstellen und aktualisieren. Das hält die Mock-Ausgabe genau, wann immer sich der Vertrag ändert, ohne dass jemand die App öffnen muss, um Felder manuell zu bearbeiten.

Sobald der Mock die Frontend-Arbeit entsperrt hat, laufen dieselben Testszenarien des Projekts headless in der CI, um das echte Backend gegen denselben Vertrag zu prüfen, den der Mock beschrieben hat. Das ist ein einziger Befehl:

apidog run -t <scenario_id> -e <env_id> -r html,cli

Installieren Sie mit npm install -g apidog-cli (Node.js v16 oder neuer), authentifizieren Sie sich mit apidog login --with-token <your-token>, und Sie können dies in jede Pipeline integrieren. Unser Leitfaden zum Ausführen von Apidog in einer CI/CD-Pipeline führt Sie durch die Einrichtung. Der Mock hält das Frontend am Laufen; die CLI hält das Backend ehrlich gegenüber derselben Wahrheitsquelle.

Häufig gestellte Fragen

• Muss ich Code schreiben, um Smart Mock zu verwenden? Nein. Solange ein Endpunkt ein spezifiziertes Antwortschema hat, generiert Smart Mock automatisch realistische Daten. Sie greifen nur dann zu Code, einer Faker-Anweisung oder einem Mock-Skript, wenn Sie ein bestimmtes Feld überschreiben möchten. Eine Übersicht über die Konzepte finden Sie im Mock-API-Überblick.
• Warum gibt meine Mock-URL nichts zurück? Die häufigste Ursache ist eine fehlende Antwortdefinition am Endpunkt. Smart Mock liest das Antwortschema, also fügen Sie zuerst eines hinzu. Prüfen Sie auch, ob Ihr Pfad mit einem / beginnt und, wenn Sie Local Mock verwenden, dass der Apidog-Client geöffnet ist.
• Wie sorge ich dafür, dass Smart Mock einen bestimmten Wert anstelle eines zufälligen zurückgibt? Legen Sie das Mock-Feld der Eigenschaft fest. Ein fester Wert (Fixed value) gibt jedes Mal dasselbe zurück; eine Faker-Anweisung (Faker statement) gibt variierte, aber kontrollierte Daten zurück. Das Mock-Feld steht an der Spitze der dreistufigen Priorität von Smart Mock, daher gewinnt es immer über Namensmatching und Schema-Standardwerte.
• Können Teamkollegen einen Mock erreichen, der auf meinem Laptop läuft? Nur über Ihr lokales Netzwerk und nur, solange der Apidog-Client geöffnet ist, da Local Mock auf 127.0.0.1:4523 hört. Für den dauerhaften Zugriff schalten Sie Cloud Mock ein, das standardmäßig ausgeschaltet ist und unter https://mock.apidog.com gehostet wird.
• Welche Antwort gewinnt, wenn ich sowohl ein Beispiel als auch Smart Mock habe? Das hängt von der Standard-Mock-Methode ab. Unter „Smart Mock zuerst“ generiert Smart Mock den Body. Unter „Antwortbeispiel zuerst“ wird Ihr Antwortbeispiel vor Smart Mock verwendet. In jedem Fall überschreibt eine passende Mock Expectation beide.

Zusammenfassung

Smart Mock verwandelt ein API-Schema in einen funktionierenden Mock ohne Code und ohne Konfiguration, was genau das ist, was ein blockiertes Frontend benötigt. Definieren Sie Ihre Antwort, kopieren Sie die Mock-URL aus dem API- oder Mock-Tab und rufen Sie sie auf; wenn die Annahmen korrigiert werden müssen, straffen Sie das Schema oder setzen Sie ein Mock-Feld und denken Sie daran, dass Mock Expectations immer gewinnen. Laden Sie Apidog herunter und mocken Sie Ihren ersten Endpunkt in der Zeit, die Sie zum Lesen dieses Satzes benötigen.