Mock-REST-API-Leitfaden

Unterstützung aller gängigen HTTP-Methoden – passend zu Ihrem API-Design.

• GET - Daten abrufen
• POST - Ressourcen erstellen
• PUT - Vollständig aktualisieren
• PATCH - Teilweise aktualisieren
• DELETE - Ressourcen entfernen

Geben Sie beliebige HTTP-Statuscodes zurück, um Erfolge, Fehler und Edge Cases zu testen.

• 200OK – Erfolg
• 201Erstellt
• 400Ungültige Anfrage
• 401Nicht autorisiert
• 500Serverfehler

Geben Sie jede gültige JSON-Struktur zurück – von einfachen Objekten bis zu komplex verschachtelten Daten.

• Objekte und Arrays
• Verschachtelte Strukturen
• Arrays von Objekten
• Validierung in Echtzeit
• Korrekter Content-Type

Fügen Sie vor dem Senden der Antwort eine feste Verzögerung von bis zu 10.000 ms hinzu, um langsame Netzwerke oder serverseitige Verarbeitungszeiten zu simulieren.

Legen Sie einen Prozentsatz fest, in dem Anfragen Fehler zurückgeben. Ideal zum Testen von Fehlerbehandlung und Wiederholungslogik.

{
  "error": "Simulated error (10% error rate)",
  "triggeredBy": "random-error-rate"
}

Geben Sie nur dann einen Fehler zurück, wenn eine Anfrage einen Header mit genau dem von Ihnen festgelegten Wert enthält. Senden Sie den Header, wenn Sie den Fehler auslösen möchten, und lassen Sie ihn sonst weg.

Passt eine Anfrage zum Header, wird der Header-Fehler statt der zufälligen Fehlerrate zurückgegeben.

{
  "error": "Conditional error triggered by header X-Test-Error: down",
  "triggeredBy": "conditional-header-match"
}

Endpoints gehören zu einem Code, der 6-stelligen Subdomain in Ihrer URL. Läuft der Code ab, wird er samt allen zugehörigen Endpoints gelöscht. Neue Codes laufen nach 1 Monat ab. Nach dem Speichern eines Endpoints ändern Sie dies über die Uhr-Schaltfläche neben der URL.

Ideal für temporäre Tests oder Demos. Manuelles Aufräumen entfällt.

Füge eine Datei ein oder lade sie hoch, sieh dir die enthaltenen Endpoints in der Vorschau an, entferne die Haken bei denen, die du nicht brauchst, und importiere den Rest auf einmal in den aktuellen Code.

Bis zu 100 Endpoints und 2 MB pro Datei. Ein Endpoint, dessen Methode und Pfad schon existieren, wird übersprungen, außer du aktivierst „Vorhandene Mocks mit gleicher Methode und gleichem Pfad ersetzen“.

Sobald ein Code gespeicherte Endpoints hat, lädt „Exportieren“ sie alle als Datei herunter, die auf deine Mock-URL zeigt.

• OpenAPI 3: jeder Endpoint mit seiner Beispielantwort. Verzögerungen, Fehlersimulation und LLM-Einstellungen stehen in einer x-mockapi-dog-Erweiterung, sodass ein erneuter Import sie wiederherstellt.
• Postman-Collection v2.1: eine Anfrage pro Endpoint mit ihrer Antwort als gespeichertem Beispiel und einer {{baseUrl}}-Variablen, die auf deine Mock-URL gesetzt ist. Endpoint-Einstellungen sind nicht enthalten.

"/users/1": {
  "get": {
    "responses": { "200": { ... } },
    "x-mockapi-dog": {
      "delayMs": 500,
      "errorRate": 10,
      "errorStatusCode": 503
    }
  }
}

curl -o mocks.json \
  "https://api.mockapi.dog/api/mocks/export?code=abc123&format=openapi"

1. mockapi.dog im Tab "REST-API (JSON)" öffnen
2. Pfad an die URL anhängen und HTTP-Methode wählen
3. Eigene JSON-Antwort eingeben
4. Optionale Einstellungen konfigurieren
5. Klicke auf „Mock-Endpoint speichern“ (hake das Prüfkästchen ab, falls eines erscheint)

1. Endpoint in der Liste "Gespeicherte Endpoints" suchen
2. Auf das Stiftsymbol ("Bearbeiten") klicken
3. Methode, Antwort, Status oder Einstellungen ändern (die URL ist beim Bearbeiten gesperrt)
4. Auf "Endpoint aktualisieren" klicken

1. Endpoint suchen, der entfernt werden soll
2. Auf das Papierkorbsymbol ("Löschen") klicken
3. Der Endpoint wird sofort entfernt, ohne Bestätigungsabfrage