# WP REST API Explorer — Anwendungsbeispiele

> Praxisnahe Durchläufe mit dem WP REST API Explorer: erste Prüfung, DDEV-Seite vor dem Go-Live, Benutzer-Enumeration schließen, Login-Test und Kundenbericht.

Source: https://www.jpkc.com/db/tools/wp-api/examples/

Zurück zur Übersicht: [WP REST API Explorer](https://www.jpkc.com/db/tools/wp-api/) · Tool live öffnen: [www.jpkc.com/tools/wp-api/](https://www.jpkc.com/tools/wp-api/)

Das [Manual](https://www.jpkc.com/db/tools/wp-api/manual/) beschreibt Einrichtung, Prüflauf und jeden Tab im Detail. Diese Seite ergänzt das um **konkrete Arbeitsabläufe**, Schritt für Schritt. Die Oberfläche ist auf Englisch — Tab- und Button-Namen stehen deshalb im Original, bei Bedarf mit deutscher Erläuterung. Alle Adressen, Zahlen und Befunde hier sind **Beispiele**, keine festen Werte des Tools. Und wie immer gilt: Prüf nur Seiten, die dir gehören oder die du testen darfst.

## Beispiel 1: Die erste Prüfung einer übernommenen Seite

Du übernimmst die Betreuung von `https://example.com` und willst wissen, was die Seite über ihre API preisgibt.

1. Lade localproxy für dein System aus den GitHub-Releases (Schritt 1 der Anleitung im Tool) und starte ihn mit dem Befehl aus Schritt 2, etwa unter Linux:

   ```bash
   ./localproxy --origin "https://www.jpkc.com" --port 8765
   ```

2. Fragt dein Browser nach dem Zugriff auf das lokale Netzwerk, wähle **Allow**. Die erste Verbindung scheitert dabei immer; das Tool versucht es kurz darauf erneut.
3. Kopiere den Startkasten des Proxys in **Or paste the proxy's startup text** und klick **Connect**. Die Statuszeile meldet „Local proxy ready" mit Version.
4. Trag `https://example.com` unter **Site address** ein und klick **Check site**. Die Laufleiste zeigt die Phasen von *Discovery* bis *Final probes* und den Zähler der Anfragen, standardmäßig gegen ein Limit von 500.
5. Lies am Ende den **Quick Check**: Der Kopfsatz sagt dir, ob etwas Handlungsbedarf hat, und wie viel davon geprüft werden konnte. Steht dort etwa „We found nothing that needs action in the content we looked at (…)", beruht das auf einer **Stichprobe** — nicht auf jedem Eintrag.
6. Klapp unter **Security** die Gruppen auf. *Good to know* ist bei einer Standard-Installation selten leer: Eine öffentliche Benutzerliste oder eine lesbare WordPress-Version ist WordPress-Standard, aber gut zu wissen.
7. Für die Doku sicherst du den Stand im Tab **Snapshots** mit **Save snapshot**. Mit dieser Datei vergleichst du später, was sich geändert hat.

## Beispiel 2: Eine DDEV-Seite vor dem Go-Live prüfen

Die neue Seite läuft lokal unter `https://example.ddev.site`, und du willst sie prüfen, bevor sie öffentlich wird. Ohne Freigabe blockt der Proxy private Adressen, deshalb brauchst du localproxy **1.4.0** und `--allow-local`.

1. Trag die lokale Adresse zuerst ins Adressfeld ein — die Anleitung übernimmt den Host in den Befehl unter **Optional** → **Local sites**:

   ```bash
   ./localproxy --origin "https://www.jpkc.com" --port 8765 --allow-local "example.ddev.site"
   ```

2. Läuft DDEV über HTTPS, führe einmal `mkcert -install` auf dem Rechner aus, auf dem der Proxy läuft. Sonst lehnt der Proxy das Zertifikat ab — er prüft TLS auch lokal und lässt sich das nicht abschalten.
3. Nach **Connect** sollte die Statuszeile „local sites" nennen. Fehlt das, meldet die Diagnose später „This local address is not on the proxy's allow list."
4. **Check site.** Jetzt lohnt der Blick in **Diagnosis**: „Home page and API answer normally." ist das Ziel. Steht dort „Front end broken, API fine.", bricht das Theme oder ein Plugin die Startseite; „WordPress thinks its address starts with http://. …" heißt, dass die WordPress-Adresse noch auf `http` steht.
5. In **Plugins & Theme** siehst du, was Fremde später von deinem Plugin-Setup erkennen. Jede Spur — etwa ein Generator-Tag oder `?ver=` an Dateien — ist dort mit ihrem Signal vermerkt.

Willst du mehrere lokale Projekte prüfen, erlaubt `--allow-local "*.ddev.site"` alle DDEV-Projekte auf einmal. Starte den Proxy mit `--allow-local` nur, solange du testest.

## Beispiel 3: Benutzer-Enumeration schließen und nachprüfen

Der Security-Tab meldet unter *Good to know* „User names are public": Über `/wp/v2/users` kann jeder die Kurznamen der Autorinnen und Autoren lesen — der erste Baustein für Login-Angriffe.

1. Öffne den Befund im Tab **Security**. Unter „What you can do" steht der Rat, darunter der Link **Open the matching snippet: Hide the user list from the REST API**. Er öffnet das Snippet im [WP Code Generator](https://www.jpkc.com/db/tools/wp/manual/#code-snippets) in einem neuen Tab.
2. Erzeuge dort das Snippet als Must-use-Plugin, lege es unter `wp-content/mu-plugins/` ab und teste es auf der Seite.
3. Bevor du neu prüfst, sicherst du den alten Stand mit **Save snapshot**.
4. **Check site** erneut. Jetzt kann ein neuer Befund auftauchen: „User list is hidden, but names are visible elsewhere" (*Worth reviewing*). Die Probes P3 (Autoren-Weiterleitung `?author=`), P6 (Benutzer-Sitemap) und P7 (Embed-Daten) zeigen, wo die Namen noch herauskommen.
5. Die Karte verlinkt dafür zwei weitere Snippets: **Stop author redirects (?author=)** und **Remove the user sitemap**. Einbauen, dann noch einmal prüfen.
6. Unter **Snapshots** → **Compare** vergleichst du den gespeicherten Stand mit **Current data**. In der Zeile *Findings* bedeutet *Removed* „behoben" — sofern beide Stände den Punkt wirklich gesehen haben; sonst steht er unter *Not comparable* mit Grund.

Achtung: P1 und P3 können auf Seiten, die Scans nach Benutzernamen blocken, deine IP sperren lassen. Prüfst du die eigene, gerade gehärtete Seite mehrmals hintereinander, kann dich ihr Schutz-Plugin aussperren — die Diagnose sagt dann „Your IP may have been blocked by the site's firewall (user enumeration protection)."

## Beispiel 4: Was sieht ein Abonnent? Prüfung mit Login

Formular- oder Shop-Plugins legen Daten manchmal so an, dass angemeldete Nutzer mit niedriger Rolle mehr lesen können als Besucher. Das prüfst du mit einem Testkonto.

1. Lege in WordPress ein Testkonto mit der Rolle **Subscriber** an und erzeuge im Profil ein Anwendungspasswort. WordPress nimmt Anwendungspasswörter nur über HTTPS an, lokale Seiten ausgenommen.
2. Prüf die Seite zuerst **ohne** Login mit **Check site** — erst danach lässt sich **Apply** benutzen.
3. Öffne **Credentials**, wähle **Application password**, trag Benutzername und Anwendungspasswort ein und klick **Apply**. Das Tool schickt eine Anfrage an `users/me` und meldet, ob der Login gilt. Bietet der Browser das Speichern an: **Never**.
4. **Check site** erneut. Nach dem öffentlichen Durchgang laufen *Logged-in extras*, *Logged-in inventory* und *Logged-in sample*; das Request-Limit teilt sich dabei 40 zu 60 auf. Am Ende steht im Bereich **Credentials** „This check ran with your login · role: subscriber".
5. Im **Security**-Tab sind jetzt die beiden Login-Prüfungen gelaufen: ob Konten mit wenigen Rechten die Abilities von Plugins sehen, und ob sie Personendaten oder Geheimnisse lesen, die Besucher nicht sehen. Ein *Action needed* hier ist ernst zu nehmen.
6. Danach **Forget** — oder die Seite neu laden. Die Zugangsdaten stehen in keinem Bericht, keinem Export und keinem Snapshot. Lösch das Anwendungspasswort in WordPress, wenn du es nicht mehr brauchst.

## Beispiel 5: „The response is not a valid JSON response" im Block-Editor

Eine Kundin meldet, dass der Editor beim Speichern diese Meldung zeigt.

1. **Check site** auf ihre Seite. Im Tab **Diagnosis** steht als Urteil: „The API answers, but PHP messages come before the data. The block editor then shows ‘The response is not a valid JSON response.’"
2. Die Karte **Requests** zeigt die Anfragen der Diagnose; die mit „evidence" markierten Zeilen tragen das Urteil, ihre Ausschnitte stehen als reiner Text da.
3. Enthält die PHP-Meldung einen Dateipfad, meldet der Security-Tab zusätzlich einen Befund der Prüfung „Error responses show PHP file paths" (hier in der Variante „API answers show PHP file paths"). Der Rat dort: die Anzeige von PHP-Fehlern abschalten (`display_errors`, `WP_DEBUG_DISPLAY`) und die Meldung selbst beheben.
4. Ein verwandter Fall ist ein **BOM** vor den Daten: „The API answers with a byte order mark (BOM) before the data." Browser und Editor stört das nicht, serverseitige Clients wie PHPs `json_decode` nach `wp_remote_get` schon — typisch für eine PHP-Datei, die mit BOM gespeichert wurde.

## Beispiel 6: Ein Bericht für die Kundin

Nach einem Wartungsauftrag willst du dokumentieren, wie die Seite dasteht.

1. Prüf die Seite vollständig und warte, bis der Lauf „Finished" meldet. Stoppst du vorher, enthält der Bericht nur das bis dahin Geladene.
2. Im Tab **Reports** zeigt **What these reports cover**, was geprüft wurde und was offen ist. Stehen unter „Still open" Proben, schickst du sie nach oder lässt sie bewusst weg.
3. Trag unter **Prepared by** deinen Agenturnamen ein. Er erscheint nur im Kundenbericht.
4. Schalte auf **Customer report** und lies die **Preview**: Klartext, nur Zahlen und betroffene Inhaltstypen, keine Routen, keine Namen, keine Belege. Der Kopfsatz ist derselbe wie im Quick Check.
5. Mit **Download report pack (ZIP)** bekommst du README, technischen Bericht und Kundenbericht in einem Paket. Den technischen Bericht behältst du für dich oder die Entwicklung; er nennt Routen, Belege und Feldpfade, maskiert aber E-Mail-Adressen, Telefonnummern, Bankdaten und Schlüssel.
6. Brauchst du die geladenen Inhalte als Tabelle, nimmst du im Tab **Export** das Format **CSV**: eine Tabelle je Inhaltstyp, dazu Befunde und Request-Log. **Make umlauts work in Excel (adds a BOM)** ist schon eingeschaltet — lass es an, wenn die Kundin die Dateien in Excel öffnet.

Für die Strategie dahinter — wie du Stufen und Stichproben liest und wo die Grenzen liegen — siehe die [Tipps & Tricks](https://www.jpkc.com/db/tools/wp-api/tips/).

