AUTH311: Route REST mancante

Cosa significa

La route del negozio WCPOS non è disponibile.

Chiedi all'amministratore del sito di verificare se un plugin di sicurezza o un proxy sta rimuovendo le intestazioni delle richieste WCPOS.

Cosa fare

È necessaria una modifica delle impostazioni prima che questo possa funzionare. Riprova dopo aver apportato la modifica indicata sopra; riprovare senza averla apportata fallirà allo stesso modo.

I tuoi dati

Nessun dato relativo a ordini o prodotti viene compromesso. Se il problema persiste, rivolgiti alla persona che gestisce il tuo sito WordPress.

Risoluzione dei problemi

1. Verifica che WCPOS sia attivo sul sito: WP Admin → Plugin.
2. Prova in un browser entrambe le forme REST supportate: l'indirizzo /wp-json/ del tuo negozio e /index.php?rest_route=/. Diagnostica un blocco REST solo se nessuno dei due indirizzi restituisce JSON.
3. Se nessuna delle due forme REST funziona, chiedi all'amministratore del sito se un plugin di sicurezza, un proxy o una CDN sta rimuovendo le intestazioni delle richieste WCPOS o bloccando le richieste REST — le regole del firewall e le opzioni di protezione che disattivano la REST API sono le cause più comuni.
4. Su alcuni hosting, risalvare i permalink (Impostazioni → Permalink → Salva) ripristina le route REST mancanti.

Dove cercare

Quando WCPOS riesce a salvare questo errore, viene registrato sul dispositivo che lo ha generato. Apri Stato del negozio → Log (l'icona a forma di battito cardiaco in fondo al menu di navigazione), individua la voce contrassegnata con questo codice ed espandila: la riga espansa mostra il motivo in linguaggio semplice e il contesto acquisito nel momento dell'errore. Per una richiesta al negozio, quel contesto può includere il codice di errore del server stesso (serverCode), lo status HTTP o l'endpoint; i campi mostrati dipendono da dove si è verificato l'errore. Quando segnali un problema, usa Copia informazioni di debug in cima alla schermata dei Log (Condividi informazioni di debug su smartphone e tablet) anziché gli screenshot: raccoglie la versione dell'app, lo stato della connessione e gli errori più recenti. I log vengono conservati per un massimo di 30 giorni, quindi raccoglili finché il problema è recente. Copia anche qualsiasi errore della console del browser comparso prima che il POS riuscisse a scrivere la propria voce di log.

Oltre al log presente nell'app, questo errore può lasciare tracce in:

• Ispettore di rete (web e desktop): apri gli strumenti per sviluppatori — premi F12 nel browser, oppure Avanzate → Attiva/disattiva strumenti per sviluppatori nel menu dell'app desktop — e seleziona la scheda Rete. Segui prima le indicazioni sui nuovi tentativi riportate in questa pagina; riproduci l'azione solo quando quei passaggi indicano che è sicuro farlo. Una richiesta non riuscita mostra lo stato HTTP e il corpo grezzo della risposta, comprese le pagine di errore che non arrivano mai al log del POS.
• WooCommerce → Stato → Log: sul sito WordPress, controlla il file fatal-errors-*.log più recente per individuare gli arresti anomali di PHP, oltre a qualsiasi origine di log che porti il nome di un plugin coinvolto nell'errore. Un errore di classe 500 proveniente dal negozio lascia quasi sempre qui la propria causa.

Dettagli

• Codice: AUTH311 (REST_ROUTE_MISSING)
• Gravità: error
• Introdotto in: WCPOS 1.10.0