mockapi.dog

Mock-REST-API-Leitfaden

Erstellen Sie kostenlose, sofortige REST-API-Endpoints mit eigenen Antworten, Statuscodes und erweiterten Funktionen. Ohne Anmeldung.

Erste Schritte

Das Erstellen eines Mock-REST-API-Endpoints dauert weniger als 30 Sekunden. Folgen Sie diesen einfachen Schritten:

  1. 1

    Startseite besuchen

    Gehen Sie zu mockapi.dog und wählen Sie den Tab "REST API".

  2. 2

    Pfad und HTTP-Methode festlegen

    Geben Sie Ihren Ressourcenpfad hinter der generierten URL ein (zum Beispiel /api/users) und wählen Sie dann GET, POST, PUT, PATCH oder DELETE.

  3. 3

    JSON-Antwort schreiben

    Wählen Sie einen Statuscode und geben Sie das JSON ein, das der Endpoint zurückgeben soll. Der Editor validiert das JSON während der Eingabe.

    {
  "id": 1,
  "name": "John Doe",
  "email": "john@example.com"
}
  4. 4

    Verzögerungen und Fehlersimulation konfigurieren (optional)

    Fügen Sie eine Antwortverzögerung, eine zufällige Fehlerrate oder einen per Request-Header ausgelösten Fehler hinzu.

  5. 5

    Verifizierung abschließen und speichern

    Schließen Sie die Turnstile-Verifizierung ab und klicken Sie auf "Mock-Endpoint speichern". Die Endpoint-URL wird automatisch kopiert!

    https://abc123.mockapi.dog/api/users

Ihr Endpoint ist sofort live!

Kein Deployment, kein Warten. Senden Sie sofort Anfragen aus Ihrer App, Ihren Tests oder Tools wie Postman und curl.

Kernfunktionen

HTTP-Methoden

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

Statuscodes

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

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

JSON-Antworten

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

Erweiterte Funktionen

Optimieren Sie Ihre Mock-Endpoints mit leistungsstarken Funktionen für realistische Testszenarien.

Antwortverzögerungen

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.

Anwendungsfälle:

  • Ladezustände in der UI testen
  • Langsame 3G/4G-Netzwerke simulieren
  • Timeout-Verhalten verifizieren
  • Skeleton-Screens prüfen

Beispiel-Verzögerungen:

500 ms – schnell2000 ms – normal5000 ms – langsam

Fehlersimulation

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

Anwendungsfälle:

  • Error Boundaries testen
  • Wiederholungsmechanismen verifizieren
  • Fehlermeldungen prüfen
  • Fallback-UI validieren

Beispiele für Fehlerraten:

10 % Fehler50 % Fehler100 % Fehler

Body der Fehlerantwort:

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

Bedingte Fehler

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.

Beispiel-Anwendungsfälle:

  • Authentifizierungsfehler:X-Test-Auth: expired gibt 401 zurück, um Ihre Login-Weiterleitung zu testen
  • Nicht gefunden:X-Test-Error: missing gibt 404 zurück, um leere Zustände zu testen
  • Ausfall:X-Test-Error: down gibt 503 zurück, um Ihre Fallback-UI zu testen

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

Body der Fehlerantwort:

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

TTL (Time to Live)

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.

Verfügbare Optionen:

1 Woche1 Monat (Standard)3 MonateBenutzerdefiniert (1–365 Tage)

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

Request Inspector

Verfolgen Sie eingehende Anfragen an Ihre Endpoints in Echtzeit. Aktivieren Sie dazu den Schalter "Logging" im Bereich "Request Inspector" unterhalb Ihrer gespeicherten Endpoints.

  • Die letzten 50 Anfragen an den Code, neueste zuerst
  • Methode, Pfad, Statuscode und Antwortzeit
  • Header, Query-Parameter und Request-Body (Bodys über 10 KB werden gekürzt)
  • Authorization- und Cookie-Header werden als [redacted] angezeigt

Logging ist standardmäßig deaktiviert und gilt für alle Endpoints des Codes. Erfasst werden nur Anfragen, die zu einem gespeicherten Endpoint passen; sie werden bis 7 Tage nach der neuesten Anfrage aufbewahrt. Sie können die Live-Ansicht jederzeit pausieren oder die Liste leeren.

Häufige Aufgaben

Endpoint erstellen

  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. Verifizierung abschließen und auf "Mock-Endpoint speichern" klicken

✓ Ihr Endpoint ist jetzt live!

Endpoint bearbeiten

  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

✓ Änderungen sind sofort live

Endpoint löschen

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

Diese Aktion kann nicht rückgängig gemacht werden

Endpoint testen

Mit curl:

curl https://abc123.mockapi.dog/api/users

Mit JavaScript:

fetch('https://abc123.mockapi.dog/api/users')

Fehlerbehebung

Endpoint gibt 404 (Not Found) zurück

Solution: Prüfen Sie URL, HTTP-Methode und Pfad: Alle drei müssen mit Ihren gespeicherten Angaben übereinstimmen. Ist das der Fall, ist der Code möglicherweise abgelaufen und wurde samt seinen Endpoints gelöscht.

Fehlermeldung über ungültiges JSON beim Erstellen des Endpoints

Solution: Validieren Sie Ihr JSON mit dem integrierten Editor. Häufige Probleme: fehlende Kommas, Schlüssel ohne Anführungszeichen, abschließende Kommas oder nicht escapete Anführungszeichen.

CORS-Fehler im Browser

Solution: Alle Endpoints enthalten automatisch CORS-Header. Wenn weiterhin Fehler auftreten, prüfen Sie, ob Sie die korrekte URL und HTTP-Methode verwenden.

Endpoint ist zu langsam

Solution: Prüfen Sie, ob in den erweiterten Einstellungen eine Antwortverzögerung konfiguriert ist. Reduzieren oder entfernen Sie den Wert, falls nicht benötigt.

Anfragen geben 429 Too Many Requests zurück

Solution: Jeder Endpoint hat ein tägliches Aufruflimit. Ist es erreicht, geben Aufrufe 429 zurück, mit dem Limit und einem resetAt-Zeitpunkt (Mitternacht Serverzeit) im Body. Zusätzlich ist jede IP-Adresse dienstweit auf 100 Anfragen pro Minute begrenzt.

Request Inspector zeigt keine Anfragen

Solution: Logging ist standardmäßig deaktiviert. Aktivieren Sie den Schalter "Logging" im Bereich "Request Inspector" und rufen Sie den Endpoint dann erneut auf. Anfragen an Pfade ohne gespeicherten Endpoint werden nicht erfasst.

Tipps und Best Practices

Realistische Daten verwenden

Verwenden Sie realistische Feldnamen, Datentypen und Strukturen, die zu Ihrer echten API passen. Das macht Tests aussagekräftiger.

Edge Cases testen

Erstellen Sie Endpoints für leere Arrays, null-Werte und Fehlerszenarien. So fangen Sie Bugs früh ab.

Endpoints dokumentieren

Pflegen Sie eine Liste Ihrer Endpoints und ihrer Zwecke. Teilen Sie URLs mit Teammitgliedern für die Zusammenarbeit.

Verzögerungen gezielt nutzen

Fügen Sie kleine Verzögerungen hinzu, um Ladezustände zu testen. Längere Verzögerungen helfen, Timeout-Verhalten zu prüfen.

Antworten versionieren

Erstellen Sie für verschiedene API-Versionen mehrere Endpoints. Das hilft beim Testen der Abwärtskompatibilität.

Ungenutzte Endpoints aufräumen

Löschen Sie regelmäßig Endpoints, die Sie nicht mehr benötigen. Verwenden Sie TTL für temporäre Endpoints, die automatisch ablaufen.

Sofort einsatzbereite Mock-API-Bibliothek

Wir bieten vorgefertigte Mock-APIs für gängige Anwendungsfälle. Klicken Sie auf eine Kategorie, um sofort einsatzbereite Endpoints zu erkunden – ohne Setup.

Users-API

Benutzerprofile, Rollen, Berechtigungen und Kontoverwaltung

Posts-API

Blogposts und Artikel mit gängigen Content-Management-Patterns

Todos-API

Klassisches CRUD-Beispiel mit Status, Filter und Pagination

Auth-API

Login, Logout, Refresh-Tokens und Benutzerregistrierung

Products-API

E-Commerce-Produkte mit Preis, Verfügbarkeit und Metadaten

Orders-API

Bestellverwaltung mit State-Workflows und Benutzerzuordnung

Cart-API

Warenkorb mit Artikelverwaltung und Beziehungen

Payments-API

Zahlungsabwicklung mit asynchronen Vorgängen und Webhooks

Profi-Tipp: Vollständige Bibliothek durchstöbern

Besuchen Sie unsere Mock-API-Bibliothek , um alle vorgefertigten Endpoints mit Live-Beispielen, Beispielantworten und Ein-Klick-Tests zu erkunden.

Glossar

REST-API

Representational State Transfer API – ein Architekturstil zum Bau von Webdiensten mit Standard-HTTP-Methoden.

HTTP-Methoden

Standard-Anfragemethoden (GET, POST, PUT, PATCH, DELETE), die die gewünschte Aktion auf eine Ressource angeben.

Statuscode

Dreistelliger Code, den der Server zurückgibt und der das Ergebnis einer Anfrage signalisiert (200 OK, 404 Not Found, 500 Error usw.).

JSON

JavaScript Object Notation – ein leichtgewichtiges Datenformat zur Strukturierung und zum Austausch von Daten zwischen Client und Server.

Endpoint

Eine spezifische URL, unter der eine API erreichbar ist. Jeder Endpoint erfüllt eine bestimmte Funktion.

Mock-API

Eine simulierte API, die vordefinierte Antworten zurückgibt – für Tests und Entwicklung ohne echtes Backend.

CORS

Cross-Origin Resource Sharing – ein Sicherheitsmechanismus, der steuert, welche Domains aus Browsern auf Ihre API zugreifen dürfen.

TTL

Time To Live – die Dauer, die ein Code und alle zugehörigen Endpoints bestehen, bevor sie automatisch gelöscht werden.

Fehlerrate

Der Anteil der Anfragen, die Fehler zurückgeben sollen. Wird zum Testen von Fehlerbehandlung und Wiederholungslogik genutzt.

Antwortverzögerung

Künstliche Wartezeit, die vor dem Senden einer Antwort eingefügt wird. Simuliert langsame Netzwerke oder Verarbeitung.

Code

Die eindeutige 6-stellige Subdomain Ihrer Mock-API (abc123 in abc123.mockapi.dog). Endpoints, Ablaufzeit und Request-Logging sind jeweils an einen Code gebunden.

Request Inspector

Ein Live-Log der Anfragen, die bei den Endpoints eines Codes eingehen, inklusive Header, Query-Parameter und Body.

Bereit für Ihre erste REST-API?

Beginnen Sie in Sekunden mit dem Bau kostenloser Mock-REST-API-Endpoints. Ohne Anmeldung, ohne Kreditkarte. Ideal für Tests, Prototyping und Entwicklung.

REST-Endpoint jetzt erstellen →← Zurück zur Doku