# 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](/content/de/index.html) und wählen Sie den Tab "REST API". 2. 2 #### HTTP-Methode wählen Wählen Sie GET, POST, PUT, PATCH oder DELETE – passend zu Ihren Anforderungen. 3. 3 #### JSON-Antwort schreiben Geben Sie die JSON-Daten ein, die der Endpoint zurückgeben soll. Der Editor validiert das JSON in Echtzeit. ```json { "id": 1, "name": "John Doe", "email": "john@example.com" } ``` 4. 4 #### Verzögerungen und Fehlersimulation konfigurieren (optional) Fügen Sie bei Bedarf Verzögerungen, Statuscodes, Fehlerraten oder eigene Header 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. - 200 OK – Erfolg - 201 Erstellt - 400 Ungültige Anfrage - 401 Nicht autorisiert - 500 Serverfehler ### 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 Simulieren Sie langsame Netzwerke oder serverseitige Verarbeitungszeiten, indem Sie Antworten Verzögerungen hinzufügen. 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 – schnell 2000 ms – normal 5000 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 % Fehler 50 % Fehler 100 % Fehler ### Bedingte Fehler Geben Sie Fehler basierend auf bestimmten Bedingungen wie Header-Werten oder Anfragemustern zurück. Beispiel-Anwendungsfälle: - Fehlender Header: 401 zurückgeben, wenn der Header X-API-Key nicht vorhanden ist - Bestimmte ID: 404 für userId "999" zurückgeben, um Not-Found-Szenarien zu testen - Anfragemethode: 405 für nicht unterstützte HTTP-Methoden zurückgeben ### TTL (Time to Live) Legen Sie eine Ablaufzeit für Ihre Endpoints fest. Sie werden nach der angegebenen Dauer automatisch gelöscht. Verfügbare Optionen: 1 Stunde 24 Stunden 7 Tage 30 Tage Ideal für temporäre Tests oder Demos. Manuelles Aufräumen entfällt. ## Häufige Aufgaben ### Endpoint erstellen 1. Auf "REST-Endpoint erstellen" klicken 2. HTTP-Methode wählen 3. Eigene JSON-Antwort eingeben 4. Optionale Einstellungen konfigurieren 5. Auf "Endpoint erstellen" klicken ✓ Ihr Endpoint ist jetzt live! ### Endpoint bearbeiten 1. Endpoint in der Liste "Meine Endpoints" suchen 2. Auf "Bearbeiten" klicken 3. Antwort, Status oder Einstellungen ändern 4. Änderungen speichern ✓ Änderungen sind sofort live ### Endpoint löschen 1. Endpoint suchen, der entfernt werden soll 2. Auf "Löschen" klicken 3. Löschung bestätigen 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 die Endpoint-URL doppelt. Verwenden Sie genau die nach der Erstellung bereitgestellte URL einschließlich der eindeutigen ID. #### 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. ## 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. ## 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 Endpoint vor der automatischen Löschung existiert. Praktisch für temporäre Tests. #### 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.