WP REST API Explorer — Tipps & Tricks
Kniffe für den WP REST API Explorer: Befunde richtig lesen, Request-Limit und IP-Sperren, Proxy-Stolperfallen, Login-Tests und Kombination mit anderen Tools.
Zurück zur Übersicht: WP REST API Explorer · Tool live öffnen: www.jpkc.com/tools/wp-api/
Das Manual erklärt jeden Tab, die Beispiele zeigen die Arbeitsabläufe. Hier geht es um das, was zwischen den Zeilen steht: wie du ein Ergebnis einordnest, wo Prüfungen dich selbst treffen können und welche Kombinationen sich lohnen. Die Oberfläche ist auf Englisch — die echten Namen stehen deshalb im Original.
Befunde richtig lesen
- Es gibt keine Gesamtnote — und das ist Absicht. Eine Zahl wie „87 von 100" würde eine öffentliche Benutzerliste und einen offen lesbaren Stripe-Schlüssel gegeneinander verrechnen. Der Explorer zählt stattdessen je Stufe. Lies zuerst Action needed, dann Worth reviewing; Good to know ist meist WordPress-Standard, den du bewusst so lassen oder schließen kannst.
- Not checked ist kein OK. Eine Prüfung, die nicht laufen konnte — Limit erreicht, Seite bat um Pause, Bot-Schutz, Login nötig —, steht mit Grund unter Not checked. Bevor du einer Kundin „alles in Ordnung" sagst, schau, wie lang diese Liste ist.
- confirmed oder likely? confirmed hat das Tool in einer Antwort gesehen, und der Beleg zeigt es. likely folgt aus einem indirekten Signal, etwa Index-Daten oder Feldnamen. Ein likely ist ein Anlass, selbst nachzusehen — keine Gewissheit.
- Eine Stichprobe beweist keine Abwesenheit. Der Lauf liest je Liste nur eine Stichprobe. Steht im Kopfsatz „in the content we looked at", heißt das genau das. Für eine belastbare Aussage über sensible Daten lädst du die betroffenen Listen in Content mit Load all items vollständig; der Muster-Scan nimmt nachgeladene Daten von selbst mit.
- „Nothing needs action right now." ist streng. Diesen Satz zeigt der Quick Check nur nach einem vollständigen Lauf mit allem geladen. Bei einer Stichprobe oder einem Teil-Lauf ist die Formulierung bewusst vorsichtiger.
Request-Limit und Tempo
- 500 Anfragen reichen für viele kleine und mittlere Seiten. Große Seiten mit vielen Inhaltstypen brauchen mehr. Endet der Lauf mit „Results are incomplete: the limit of … site requests was reached.", hebst du das Request limit in den Run settings an und klickst Run remaining checks — der Lauf macht dort weiter, statt von vorn zu beginnen.
- Das Limit gilt für die ganze Prüfung, auch für deine Klicks danach. Einzelne Klicks dürfen darüber hinaus, vollständige Abzüge halten am Limit an. Bei mehreren großen Abzügen also lieber vorher großzügig planen.
- Langsamer ist manchmal schneller. Antwortet eine Seite träge oder bittet sie per
Retry-Afterum Pause, senk Parallel requests auf 1 und Rate auf 0.5 oder 1. Mehr als 60 Anfragen pro Minute schickt das Tool ohnehin nie. Für große Seiten empfiehlt die Anleitung im Tool, den Proxy mit--timeout 60zu starten. - Die Kosten stehen an jedem Knopf. „(1 request)", „(≈ 4 requests)", „(12 requests)" — der Explorer sagt dir vorher, was ein Klick an die Seite schickt. Das Request-Log zeigt hinterher jede einzelne Anfrage.
Nicht die eigene IP sperren
- P1 und P3 sind die heiklen Proben. Die Anfrage nach einer nicht existierenden Benutzernummer und die Autoren-Weiterleitung
?author=sehen für Sicherheits-Plugins wie ein Scan nach Benutzernamen aus. Das Tool schickt beide deshalb ganz zum Schluss, warnt im Security-Tab ausdrücklich und lässt sie weg, wenn die Seite vorher um Pause bittet. - Probes abschalten, wenn es heikel ist. Prüfst du eine fremde Produktivseite mit strengem Schutz, schalte in den Run settings Include probes aus. Die betroffenen Prüfungen stehen dann unter Not checked; einzelne Proben schickst du später gezielt mit Send this probe (1 request) nach.
- Pausiert der Lauf mit „The site has started refusing requests", warte ein paar Minuten, bevor du Resume drückst. Meldet die Diagnose „Your IP may have been blocked by the site's firewall (user enumeration protection).", hilft nur warten oder deine IP in der Firewall der eigenen Seite freigeben.
- Ein 403 muss nicht WordPress sein. Die Referenz sagt es: 403 kann auch die HTML-Seite einer Firewall sein, und 502/504 kommen vom Proxy, nicht von der Seite. Die Diagnose unterscheidet das; das Request-Log zeigt den Status jeder Anfrage.
Stolperfallen beim Proxy
- Der Token wechselt bei jedem Start. Nach einem Neustart meldet das Tool „The token does not match" oder, ab 1.4.0, dass der Proxy seine Echtheit nicht belegen konnte. Neuen Token kopieren, fertig. Wer das nicht ständig will, startet mit
--token-file— muss dann aber wissen: Ein gestohlener Token bleibt so über Neustarts gültig, bis du die Datei löschst. - Die erste Verbindung scheitert immer. Wenn der Browser nach dem lokalen Netzwerk fragt, ist die auslösende Anfrage verloren, auch nach „Allow". Kein Grund zur Sorge — das Tool prüft kurz darauf erneut, oder du drückst Check again.
- Doppelklick startet auf zufälligem Port. Unter Windows deshalb die
start-localproxy.cmdaus der Anleitung anlegen, oder dieAddress-Zeile aus dem Proxy-Fenster ins Feld Proxy address kopieren. - „… was started for a different site" heißt: Der Proxy läuft mit einem anderen
--origin, etwa für eine andere Website oder eine lokale Kopie der Tools. Mit dem Befehl aus der Anleitung neu starten; Copy start command baut ihn passend. --allow-localso eng wie möglich.*.ddev.siteerlaubt jedes DDEV-Projekt auf deinem Rechner. Laut Proxy-Dokumentation hängt „nur lesen" bei lokalen Zielen allein am Code des Tools — jedes Skript auf einer erlaubten Origin mit dem Token könnte dorthin auch schreiben. Starte den Proxy mit--allow-localdeshalb nur, solange du testest.- DDEV und DNS: Für DDEV-Namen nicht
--dns systemverwenden; Router mit Rebind-Schutz beantworten*.ddev.sitesonst gar nicht. Intranet-Namen dagegen brauchen--dns system. Und für HTTPS istmkcert -installauf dem Proxy-Rechner Pflicht.
Plugins, Theme und Version einordnen
- Die echte Plugin-Zahl ist fast immer höher. Ein Plugin fällt nur auf, wenn es eine Spur hinterlässt — eine Datei auf der Startseite, einen REST-Namespace, einen Inhaltstyp. Backend-Plugins ohne Frontend bleiben unsichtbar. Die vollständige Liste gibt WordPress nur Administratoren, also nur mit Login.
- „One of several plugins" ist ehrlich, nicht unentschlossen. Manche Signale teilen sich mehrere Plugins. Das Tool rät dann nicht, sondern zählt die Gruppe als ein Plugin.
- Die Version aus API-Merkmalen ist eine Untergrenze. „at least x.y" stammt aus Merkmalen, die die API anbietet; ein Generator-Tag zeigt, wenn vorhanden, die genaue Nummer, und die Seite kann ihn entfernen oder ändern. Widersprechen sich Signale, sagt das Tool das dazu. Eine Aussage, ob eine Version veraltet oder unsicher ist, trifft es bewusst nicht.
- Unbekannte Plugin-Routen nicht blind ausführen. In Structure warnt das Tool vor Run anyway aus gutem Grund: Auch eine
GET-Route kann auf der Seite etwas auslösen. Das Tool selbst schickt nurGETundHEAD(mit Login blockt zusätzlich der Proxy schreibende Methoden); Nebenwirkungen lesender Routen kann keiner von beiden verhindern.
Login-Tests mit Bedacht
- Nimm ein Testkonto mit wenig Rechten. Die Login-Prüfungen bewerten nur Rollen mit wenig Rechten: die Abilities-Prüfung nur Rollen ohne Schreibrechte (etwa Subscriber), die Prüfung auf zusätzliche Daten Subscriber und Contributor. Ein Administrator zeigt vor allem die vollständige Plugin- und Theme-Liste.
- Anwendungspasswort danach löschen. Das Tool vergisst die Zugangsdaten beim Neuladen; in WordPress bleibt das Anwendungspasswort aber gültig, bis du es entfernst.
- 401 trotz richtigem Passwort? Nach Apply nennt das Tool unter „Likely causes" die wahrscheinlichen Gründe: ein falscher Benutzername oder ein falsches Anwendungspasswort, ein Hoster, der den
Authorization-Header entfernt, bevor WordPress ihn sieht (dann hilft die übliche Rewrite-Regel in der.htaccess), ein eigener Passwortschutz per HTTP Basic Auth vor WordPress — oder bei einerhttp-Seite, dass WordPress Anwendungspasswörter ohne HTTPS abschaltet. - Leitet die Seite um, ist der Login weg. Zugangsdaten gelten nur für den Origin, für den du sie eingegeben hast. Leitet
http://aufhttps://oderwwwum, gibst du sie für die neue Adresse erneut ein.
Mit Dateien sorgsam umgehen
- Exporte enthalten Personendaten. Passwörter und Schlüssel maskiert das Tool, soweit es sie erkennt; Namen und E-Mail-Adressen der Seite bleiben in JSON, CSV und Snapshot. Behandle die Dateien entsprechend.
- „Show passwords and secret keys in full" nur für dich. Das Tool schreibt es selbst dazu: „Only for your own use. Do not pass this file on." Dasselbe gilt für Snapshots mit den Originalantworten der Seite.
- Für Kundinnen und Kunden den Kundenbericht. Er nennt keine Routen, keine Namen und keine Belege. Der technische Bericht maskiert zwar Kontaktdaten und Schlüssel, zeigt aber Autoren-Kurznamen.
- Der Download schützt dich vor dir selbst. Steckt dein Proxy-Token oder dein Login in einer Datei, verweigert das Tool das Speichern. Teilen kannst du dagegen den Link aus Copy link — er füllt beim Empfänger nur die Adresse vor, und der braucht einen eigenen Proxy.
Mit anderen JPKCom-Tools kombinieren
- WP Code Generator — die Snippets hinter Open the matching snippet erzeugst du dort als Must-use-Plugin. Einbauen, Check site wiederholen und per Compare gegen den alten Snapshot zeigen, was behoben ist. Wer lieber ein fertiges Plugin nimmt: JPKCom Disable XML-RPC schaltet XML-RPC global ab, JPKCom Harden & Trim bündelt Härtungen für WordPress.
- SEO & GEO Analyzer — bewertet HTTP-Security-Header und TLS, die der Explorer ausdrücklich nicht beurteilt, und die SEO-Seite der Startseite.
- DNS, SSL, Redirect & URL — meldet die Diagnose ein Zertifikatsproblem oder „The site redirects in a circle.", prüfst du dort Kette und Weiterleitungen Hop für Hop.
- JSON Editor — für den JSON-Export oder eine einzelne API-Antwort aus Structure: als Baum durchsuchen, mit Transform filtern oder gegen ein JSON Schema prüfen.
- CSV Editor — die CSV-Tabellen des Exports sichten und nachbearbeiten.
- Markdown Editor — die Berichte als
.mdöffnen, eigene Hinweise für die Kundin ergänzen und das Ergebnis als PDF speichern. - localproxy — Anleitung & Tipps — Hintergrund zu Download, Start und Endpunkten des Proxys; was der Explorer davon braucht, steht im Manual.