Zum Hauptinhalt springen
Version: 1.x

AUTH311: REST-Route fehlt

Was dies bedeutet

Die WCPOS-Shop-Route ist nicht verfügbar.

Bitten Sie den Website-Administrator zu prüfen, ob ein Sicherheits- oder Proxy-Plugin WCPOS-Anfrage-Header entfernt.

Was zu tun ist

Damit dies funktioniert, ist zuerst eine Änderung der Einstellungen erforderlich. Versuchen Sie es erst nach der oben genannten Änderung erneut; ohne sie schlägt der Versuch genauso fehl.

Ihre Daten

Es sind keine Bestell- oder Produktdaten betroffen. Wenn dies weiterhin auftritt, wenden Sie sich an die Person, die Ihre WordPress-Website betreut.

Fehlerbehebung

  1. Vergewissern Sie sich, dass WCPOS auf der Website aktiv ist: WP Admin → Plugins.
  2. Testen Sie beide unterstützten REST-Formen im Browser: die /wp-json/-Adresse Ihres Shops und /index.php?rest_route=/. Gehen Sie nur dann von einer REST-Blockade aus, wenn keine der beiden Adressen JSON zurückgibt.
  3. Wenn keine der REST-Formen funktioniert, fragen Sie den Website-Administrator, ob ein Sicherheits-Plugin, ein Proxy oder ein CDN WCPOS-Anfrage-Header entfernt oder REST-Anfragen blockiert — Firewall-Regeln und Härtungsoptionen zum Deaktivieren der REST-API sind die üblichen Verursacher.
  4. Auf manchen Hostings stellt das erneute Speichern der Permalinks (Einstellungen → Permalinks → Speichern) fehlende REST-Routen wieder her.

Wo Sie nachsehen können

Wenn WCPOS diesen Fehler speichern kann, wird er auf dem Gerät aufgezeichnet, das ihn ausgelöst hat. Öffnen Sie Shop-Zustand → Protokolle (das Herzschlagsymbol unten im Navigationsmenü), suchen Sie den mit diesem Code gekennzeichneten Eintrag und klappen Sie ihn auf: Die aufgeklappte Zeile zeigt die Ursache in verständlicher Sprache sowie den Kontext, der im Moment des Fehlers erfasst wurde. Bei einer Shop-Anfrage kann dieser Kontext den eigenen Fehlercode des Servers (serverCode), den HTTP-status oder den endpoint enthalten; welche Felder angezeigt werden, hängt davon ab, wo der Fehler aufgetreten ist. Verwenden Sie beim Melden eines Problems Debug-Infos kopieren oben im Protokollbildschirm (Debug-Infos teilen auf Smartphones und Tablets) statt Screenshots: Damit werden App-Version, Verbindungsstatus und die neuesten Fehler zusammengefasst. Protokolle werden höchstens 30 Tage aufbewahrt — sammeln Sie sie daher, solange das Problem frisch ist. Kopieren Sie außerdem jede Fehlermeldung aus der Browser-Konsole, die erschienen ist, bevor das POS seinen eigenen Protokolleintrag schreiben konnte.

Über das Protokoll in der App hinaus kann dieser Fehler an folgenden Stellen Spuren hinterlassen:

  • Netzwerk-Inspektor (Web und Desktop): Öffnen Sie die Entwicklertools — drücken Sie F12 im Browser oder wählen Sie Erweitert → Entwicklertools umschalten im Menü der Desktop-App — und wechseln Sie zum Tab Netzwerk. Befolgen Sie zuerst die Hinweise zum erneuten Versuch auf dieser Seite; wiederholen Sie die Aktion nur, wenn diese Schritte sie als unbedenklich bezeichnen. Eine fehlgeschlagene Anfrage zeigt den HTTP-Status und den unbearbeiteten Antworttext, einschließlich Fehlerseiten, die nie im POS-Protokoll ankommen.
  • WooCommerce → Status → Protokolle: Prüfen Sie auf der WordPress-Website das neueste fatal-errors-*.log auf PHP-Abstürze sowie jede Protokollquelle, die nach einem am Fehler beteiligten Plugin benannt ist. Ein Fehler der 500er-Klasse aus dem Shop hinterlässt seine Ursache fast immer hier.

Details

  • Code: AUTH311 (REST_ROUTE_MISSING)
  • Schweregrad: error
  • Eingeführt in: WCPOS 1.10.0