AUTH311: REST-route ontbreekt

Wat dit betekent

De WCPOS-winkelroute is niet beschikbaar.

Vraag de sitebeheerder om te controleren of een beveiligings- of proxyplugin WCPOS-verzoekheaders verwijdert.

Wat je moet doen

Er is een instellingswijziging nodig voordat dit werkt. Probeer het opnieuw nadat je de bovenstaande wijziging hebt doorgevoerd; zonder die wijziging mislukt het op dezelfde manier.

Je gegevens

Er zijn geen bestel- of productgegevens getroffen. Als dit aanhoudt, vraag dan de persoon die je WordPress-site beheert.

Probleemoplossing

1. Controleer of WCPOS actief is op de site: WP Admin → Plugins.
2. Test beide ondersteunde REST-vormen in een browser: het /wp-json/-adres van je winkel en /index.php?rest_route=/. Concludeer alleen dat REST wordt geblokkeerd als geen van beide adressen JSON teruggeeft.
3. Als geen van beide REST-vormen werkt, vraag de sitebeheerder dan of een beveiligingsplugin, proxy of CDN WCPOS-verzoekheaders verwijdert of REST-verzoeken blokkeert — firewallregels en hardeningopties die de REST API uitschakelen zijn de gebruikelijke boosdoeners.
4. Bij sommige hosts worden ontbrekende REST-routes hersteld door de permalinks opnieuw op te slaan (Instellingen → Permalinks → Wijzigingen opslaan).

Waar je moet kijken

Als WCPOS deze fout kan opslaan, wordt deze vastgelegd op het apparaat waarop de fout is opgetreden. Open Winkelstatus → Logs (het hartslagpictogram onderaan het navigatiepaneel), zoek de vermelding met deze code op en vouw deze uit: de uitgevouwen regel toont de reden in begrijpelijke taal en de context die op het moment van de fout is vastgelegd. Bij een verzoek aan de winkel kan die context de eigen foutcode van de server (serverCode), de HTTP-status of het endpoint bevatten; welke velden worden getoond, hangt af van waar de fout is opgetreden. Gebruik bij het melden van een probleem Debug-info kopiëren boven aan het Logs-scherm (Debug-info delen op telefoons en tablets) in plaats van schermafbeeldingen: dit bundelt de app-versie, de verbindingsstatus en de meest recente fouten. Logs worden maximaal 30 dagen bewaard, dus verzamel ze zolang het probleem vers is. Kopieer ook eventuele fouten uit de browserconsole die verschenen voordat de POS zijn eigen logvermelding kon schrijven.

Naast het log in de app kan deze fout ook sporen achterlaten in:

• Netwerkinspector (web en desktop): open de ontwikkelaarstools — druk op F12 in de browser of kies Geavanceerd → Ontwikkelaarstools in-/uitschakelen in het menu van de desktop-app — en ga naar het tabblad Netwerk. Volg eerst de instructies voor opnieuw proberen op deze pagina; herhaal de actie alleen wanneer die stappen aangeven dat het veilig is. Een mislukt verzoek toont de HTTP-status en de onbewerkte responsinhoud, inclusief foutpagina's die het POS-log nooit bereiken.
• WooCommerce → Status → Logs: controleer op de WordPress-site het nieuwste fatal-errors-*.log op PHP-crashes, plus elke logbron die is genoemd naar een plugin die bij de fout betrokken is. Een fout uit de 500-reeks vanuit de winkel laat de oorzaak hier vrijwel altijd achter.

Details

• Code: AUTH311 (REST_ROUTE_MISSING)
• Ernst: error
• Geïntroduceerd in: WCPOS 1.10.0