Wenn Sie einen gefälschten API-Endpunkt brauchen, der einen bestimmten JSON-Body, Statuscode und Header zurückgibt, ohne einen Server aufzusetzen, ist Mocky oft der schnellste Weg. Dieser Leitfaden zeigt, wie Sie Mocky praktisch einsetzen, wann es reicht und wann Sie auf eine vollständige Mocking-Plattform wechseln sollten. Für den breiteren Überblick lesen Sie auch unsere Vergleichsliste der Online-API-Mocking-Tools sowie Mockys eigenes Open-Source-Repository.
Was ist Mocky?
Mocky ist ein kostenloser Open-Source-Webdienst zum Erzeugen benutzerdefinierter HTTP-Antworten. Sie definieren im Browser eine Antwort, Mocky generiert eine eindeutige URL, und jede Anfrage an diese URL liefert genau diese Antwort zurück.
Das bedeutet:
- kein Backend-Code
- kein Deployment
- kein eigener Server
- sofort teilbare Mock-URL
Mocky wurde von Julien Lafont entwickelt und unter der Apache-2.0-Lizenz veröffentlicht. Die gehostete Version läuft unter mocky.io. Da der Code öffentlich ist, können Sie Mocky bei Bedarf auch selbst hosten.
Die Kernidee lautet: Sie legen eine Antwort hinter eine URL. Genau dieser Fokus macht Mocky für schnelle Tests nützlich.
Was Sie mit Mocky konfigurieren können
Mocky deckt die wichtigsten Bestandteile einer HTTP-Antwort ab:
-
Statuscode, zum Beispiel
200,404oder500 - Response Body, meistens JSON, aber auch andere Textinhalte
-
HTTP-Header, etwa
Content-Typeoder eigene Header - Antwortverzögerung, um langsame Netzwerke oder träge Upstreams zu simulieren
Nach dem Speichern erhalten Sie eine permanente URL. Diese URL können Sie direkt in Frontend-Code, Tests oder Tools wie curl, Postman oder Apidog verwenden.
Schnelles Beispiel: Benutzerobjekt mocken
Angenommen, Ihr Backend ist noch nicht fertig, aber Ihr Frontend benötigt bereits ein Benutzerobjekt.
In Mocky würden Sie:
- den Statuscode auf
200setzen - den Header
Content-Type: application/jsonhinzufügen - diesen Body einfügen:
{
"id": 42,
"name": "Ada Lovelace",
"role": "admin"
}
Mocky erzeugt anschließend eine URL wie:
https://run.mocky.io/v3/<some-id>
Im Frontend können Sie diese URL direkt verwenden:
const response = await fetch("https://run.mocky.io/v3/<some-id>");
const user = await response.json();
console.log(user.name);
Jeder Aufruf gibt denselben Benutzer zurück. Für einfache UI-Entwicklung reicht das oft aus. Einen tieferen Einstieg finden Sie in unserem Leitfaden dazu, wie man APIs online mockt, ohne einen Server einzurichten.
Wann Mocky die richtige Wahl ist
Mocky eignet sich besonders für kleine, statische Szenarien:
- Sie brauchen schnell eine einzelne statische Antwort.
- Sie möchten eine feste Payload mit einem Teammitglied teilen.
- Sie reproduzieren einen Fehlerfall, etwa eine 500 Internal Server Error Response.
- Die Antwort muss sich nicht anhand der Anfrage ändern.
- Sie möchten ohne Konto oder Setup starten.
Für solche Aufgaben ist Mocky schwer zu schlagen. Öffnen, Antwort definieren, URL kopieren, fertig.
Wo Mocky an seine Grenzen stößt
Mockys Einfachheit ist gleichzeitig die größte Einschränkung. Eine Mocky-URL entspricht einer festen Antwort. Sobald Ihr API-Mocking mehr Struktur braucht, entstehen typische Probleme.
1. Keine dynamischen Daten
Jeder Aufrufer erhält denselben Body.
Sie können also nicht ohne Weiteres so etwas abbilden:
GET /users/1 -> Benutzer 1
GET /users/2 -> Benutzer 2
Mit Mocky brauchen Sie dafür separate URLs oder manuelle Workarounds.
2. Keine Request-Matching-Logik
Mocky verzweigt nicht anhand von:
- Query-Parametern
- Pfadparametern
- Request-Headern
- Request-Bodies
Eine URL bedeutet eine Antwort.
3. Schwierige Organisation bei vielen Endpunkten
Eine echte API besteht schnell aus vielen Endpunkten:
GET /users
GET /users/{id}
POST /orders
GET /orders/{id}
POST /auth/login
Wenn jeder Mock eine eigene Mocky-URL ist, fehlt eine gemeinsame Projektstruktur und Basis-URL.
4. Begrenzte Zusammenarbeit
Mocky bietet keinen gemeinsamen Workspace mit:
- Teamrollen
- Versionierung
- zentraler API-Struktur
- synchronisiertem Schema
- gemeinsamer Mock-Umgebung
5. Keine direkte Schema-Verknüpfung
Ihre OpenAPI-Spezifikation und Ihre Mocky-Antworten leben getrennt. Dadurch können Schema und Mock-Daten mit der Zeit auseinanderdriften.
Wenn Sie mehrere dieser Grenzen erreichen, ist der Wechsel auf eine vollständige Mock-Plattform sinnvoll. Unser Leitfaden zu kostenlosen und günstigen API-Mock-Servern zeigt weitere Optionen.
Typisches Team-Szenario
Ein häufiger Auslöser ist die Frontend-Entwicklung.
Beispiel:
- Entwickler A mockt
GET /users/42 - Entwickler B mockt
GET /orders - Entwickler C mockt
POST /auth/login
Mit Mocky entstehen drei voneinander getrennte Links. Es gibt keine gemeinsame Basis-URL, keine zentrale Umgebung und keine einheitliche API-Struktur.
Mit einem echten Mock-Server liegen diese Endpunkte in einem Projekt:
https://mock.example.com/users/42
https://mock.example.com/orders
https://mock.example.com/auth/login
Das ist leichter zu warten, zu teilen und später gegen Staging- oder Produktionsdaten auszutauschen.
Die beste Mocky-Alternative: Apidog
Apidog übernimmt Mockys Grundidee: eine benutzerdefinierte Antwort hinter einer teilbaren URL. Zusätzlich bietet Apidog Funktionen, die bei größeren APIs wichtig werden:
- mehrere Endpunkte in einem Projekt
- schema-gesteuerte Mock-Daten
- dynamische Antworten
- bedingte Mock-Regeln
- Teamzusammenarbeit
- gehostete Mock-URLs
Sie definieren Ihre Endpunkte, und Apidog generiert Mock-URLs, die Statuscodes, Header und JSON-Bodies zurückgeben. Der Unterschied: Diese Mocks sind an Ihr API-Design gebunden.
Kurz gesagt:
- Mocky: „Gib mir sofort eine feste Antwort.“
- Apidog: „Gib mir einen realistischen Mock einer API, der mit dem Projekt wächst.“
Was Apidog zusätzlich bietet
Smart Mock und KI-generierte Daten
Statt jeden Body fest zu codieren, kann Apidog realistische Werte aus Feldnamen und Schemas ableiten.
Beispiel:
{
"email": "user@example.com",
"createdAt": "2025-01-01T10:00:00Z",
"firstName": "Ada"
}
Felder wie email, createdAt oder firstName können dadurch plausiblere Mock-Werte erhalten.
Faker.js-Unterstützung
Mit Faker.js in Apidog können Sie dynamische Testdaten erzeugen, statt immer dieselbe Payload zurückzugeben.
Beispielhafte Idee:
{
"id": 42,
"name": "{{faker.person.fullName}}",
"email": "{{faker.internet.email}}"
}
So erhalten Clients bei Aufrufen realistischere und variablere Daten.
Bedingte Mock-Regeln
Apidog kann unterschiedliche Antworten anhand von Anfrageinhalten zurückgeben.
Beispiel:
GET /users?role=admin -> Admin-Liste
GET /users?role=guest -> Guest-Liste
Das ist besonders nützlich für Frontend-Zustände, Fehlerfälle und Edge Cases.
Schema-basiertes Mocking
Wenn Sie OpenAPI verwenden, können Mocks aus Ihrem API-Design generiert werden. Dadurch bleiben Spezifikation und Mock näher beieinander.
Team-Arbeitsbereiche
Mocks liegen in einem gemeinsamen Projekt statt in verstreuten Einmal-Links. Das macht Zusammenarbeit, Review und Wartung einfacher.
Mocky vs. Apidog auf einen Blick
| Funktion | Mocky | Apidog |
|---|---|---|
| Benutzerdefinierter Status, Header und Body hinter einer URL | Ja | Ja |
| Kostenlos starten, keine Einrichtung | Ja | Ja, kostenloser Plan |
| Einzelne statische Antwort | Ja | Ja |
| Dynamische Daten mit Faker.js oder Smart Mock | Nein | Ja |
| Request Matching / bedingte Regeln | Nein | Ja |
| Viele Endpunkte in einem Projekt | Nein | Ja |
| Schema-basierte OpenAPI-Mocks | Nein | Ja |
| Team-Arbeitsbereich und Versionierung | Nein | Ja |
| Self-Hosting-Option | Ja, Open Source | Cloud + Self-Hosting-Optionen |
Wenn Sie weitere Tools vergleichen möchten, helfen unsere Liste der besten API-Mocking-Tools und unsere Übersicht zu REST-Endpunkt-Mocking-Tools.
Wie Sie eine Mocky-URL in Apidog ersetzen
Der Wechsel von einer einzelnen Mocky-URL ist einfach.
Schritt 1: Apidog starten
Laden Sie Apidog herunter und erstellen Sie ein Projekt.
Schritt 2: Endpunkt anlegen
Legen Sie den passenden Endpunkt an, zum Beispiel:
GET /users/42
Schritt 3: Response definieren
Übertragen Sie die Daten aus Mocky:
- Statuscode
- Header
- JSON-Body
Beispiel:
{
"id": 42,
"name": "Ada Lovelace",
"role": "admin"
}
Schritt 4: Mock aktivieren
Aktivieren Sie den Mock für den Endpunkt. Apidog generiert eine gehostete Mock-URL.
Schritt 5: Client umstellen
Ersetzen Sie im Frontend oder Test die alte Mocky-URL durch die neue Mock-URL.
Beispiel:
const response = await fetch("https://your-apidog-mock-url/users/42");
const user = await response.json();
Danach können Sie schrittweise weitere Funktionen ergänzen:
- dynamische Daten
- weitere Endpunkte
- bedingte Antworten
- OpenAPI-Import
- Team-Workflows
Sie müssen nicht alles am ersten Tag migrieren.
Praktischer Migrationsansatz
Migrieren Sie nicht zwingend alle Mocky-Links auf einmal.
Ein sinnvoller Ablauf:
- Bestehende Mocky-Links weiterlaufen lassen.
- Kritische Endpunkte zuerst in Apidog nachbauen.
- Frontend oder Tests schrittweise umstellen.
- Alte Mocky-URLs entfernen, sobald alle wichtigen Endpunkte im Projekt liegen.
Wenn Sie bereits eine OpenAPI-Datei haben, können Sie diese importieren und Mock-URLs für mehrere Endpunkte auf einmal erzeugen, statt jede Antwort manuell neu anzulegen.
Häufig gestellte Fragen
Ist Mocky kostenlos?
Ja. Mocky ist kostenlos und Open Source unter der Apache-2.0-Lizenz. Sie benötigen kein Konto, um einen Mock zu erstellen. Die Antwort wird serverseitig gespeichert, und die generierte URL bleibt aktiv.
Wenn Sie mehr als eine einzelne feste Antwort brauchen, bietet eine Plattform wie Apidog zusätzlich dynamische Daten, Projektstruktur und Teamfunktionen.
Was ist der Unterschied zwischen mocky.io und einem Mock-Server?
Eine Mocky-URL ist eine feste vorbereitete Antwort.
Ein Mock-Server simuliert eine API mit mehreren Endpunkten, Request Matching und Daten, die sich je nach Anfrage ändern können.
Wenn Sie neu im Thema sind, erklärt unser Artikel, was eine Mock-API ist, die Grundlagen.
Kann ich mit Mocky einen benutzerdefinierten Statuscode und Header zurückgeben?
Ja. Genau dafür ist Mocky gedacht.
Sie definieren:
- Statuscode
- Header
- Body
- optionale Verzögerung
Die Einschränkung: Mocky liefert immer dieselbe Antwort, unabhängig von der konkreten Anfrage.
Wann sollte ich von Mocky zu einer vollständigen Mock-Plattform wechseln?
Wechseln Sie, wenn Sie eines oder mehrere dieser Dinge brauchen:
- dynamische oder realistische Daten
- unterschiedliche Antworten je nach Anfrage
- mehrere zusammenhängende Endpunkte
- zentrale Projektstruktur
- Team-Arbeitsbereiche
- OpenAPI-basierte Mocks
Bis dahin ist Mockys Einfachheit ein Vorteil.
Zusammenfassung
Mocky ist ein guter Weg, um schnell eine benutzerdefinierte HTTP-Antwort hinter eine URL zu legen. Für einzelne statische Antworten ist es einfach, kostenlos und sofort nutzbar.
Sobald Sie jedoch dynamische Daten, Request Matching, mehrere Endpunkte oder Teamzusammenarbeit benötigen, stößt das Ein-Antwort-Modell an Grenzen.
Apidog deckt denselben einfachen Anwendungsfall ab und erweitert ihn zu schema-gesteuertem, dynamischem und kollaborativem API-Mocking. Laden Sie Apidog herunter, um Ihre erste Mock-URL kostenlos zu erstellen.
Top comments (0)