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.

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

Das 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:

    ./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:

    ./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 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.