Centro risoluzione errori

WooCommerce REST API 401 Unauthorized: cause e soluzione

Come verificare chiavi API, permessi utente e header del server in caso di errore WooCommerce REST API 401?

Codariva ·

Se la tua richiesta WooCommerce REST API restituisce 401 Unauthorized, potrebbe esserci un problema nel livello di autenticazione o autorizzazione. Un errore frequente è cercare il problema nei dati del prodotto senza verificare le credenziali al primo passaggio della connessione.

Se il problema riguarda la notifica dell'ordine dal negozio all'ERP, anziché una chiamata all'API del negozio, consulta la guida alla consegna dei webhook WooCommerce e all'accettazione ERP. Il solo controllo della chiave API non verifica la firma e l'elaborazione del webhook presso il destinatario.

Cosa controllare prima?

  1. Indirizzo corretto: L'URL del negozio e il percorso /wp-json/wc/v3/ sono corretti? Viene usato HTTPS?
  2. Corrispondenza delle chiavi: Consumer Key e Consumer Secret appartengono alla stessa coppia?
  3. Livello di autorizzazione: Se la chiave ha solo permessi di lettura, una scrittura potrebbe non riuscire.
  4. Ruolo utente: L'utente WordPress associato alla chiave API ha i permessi necessari per l'operazione?
  5. Header del server: La configurazione proxy o FastCGI inoltra l'header Authorization all'applicazione?

La relazione tra chiave e utente e il perimetro di accesso sono descritti nella documentazione sull'autenticazione WooCommerce. Non determinare la causa principale basandoti soltanto sul codice HTTP.

Sequenza di diagnosi sicura

Prima di tutto, non condividere le chiavi segrete in screenshot, ticket di assistenza o URL pubblici. Testa la connessione con una richiesta API in sola lettura nell'ambiente autorizzato. Nei log delle richieste fallite conserva URL, metodo HTTP, codice di stato e orario; maschera segreti e token.

Se la lettura funziona ma la scrittura no: rivedi il perimetro di accesso e i ruoli utente. Se ogni richiesta fallisce: concentrati su chiave errata, ambiente errato o header di autenticazione del server.

Cosa evitare?

Disattivare i meccanismi di sicurezza, inserire la chiave nei parametri di un link pubblico o concedere permessi illimitati per correggere un errore in produzione non è una soluzione duratura. I controlli che impediscono accessi non autorizzati devono essere mantenuti.

Domanda frequente

401 e 404 sono la stessa cosa? No. 401 segnala un problema di autenticazione valida, mentre 404 indica spesso che la risorsa richiesta non è stata trovata. WooCommerce documenta i diversi codici di stato nel riferimento API.

Cosa fare dopo il test in sola lettura?

Scenario di esempio: La lettura con la stessa chiave funziona direttamente dal server autorizzato ma non dietro il reverse proxy. Prima di rinnovare la chiave, verifica se l'header di autenticazione viene inoltrato alla destinazione corretta. Non aggiungere la chiave alla query string creando un link condivisibile: i log del server potrebbero conservarla.

Esito Livello da esaminare
401 Credenziali e loro trasmissione
403 o messaggio di autorizzazione Perimetro della chiave e permessi dell'utente associato
404 Percorso, versione API, identificativo della risorsa e impostazione dei permalink
Lettura riuscita, scrittura fallita Permesso di scrittura e autorizzazione all'operazione; non creare ordini casuali in produzione

Leggi il codice di errore restituito da WooCommerce insieme al codice HTTP. Significato dei codici di stato HTTP. Al termine dei controlli, stabilisci quali attività precedentemente fallite elaborare di nuovo; il ripristino dell'autenticazione non significa che le attività passate siano state elaborate.

Quando chiedere supporto all'amministratore?

Se il test in sola lettura viene ancora rifiutato con l'utente e il perimetro di accesso corretti, confronta con l'amministratore del sito/hosting l'esito della stessa richiesta diretta e tramite proxy. Condividi soltanto percorso depurato, orario e codice di errore. Non disattivare in blocco i plugin di sicurezza; la persona responsabile deve esaminare in modo circoscritto la regola interessata e l'inoltro degli header.

Fonti e verifica

I flussi esemplificativi sono proposte architetturali, non progetti cliente completati né dichiarazioni di partnership con i produttori. Verifica delle fonti tecniche: 17 ottobre 2026. Versione, licenza e autorizzazioni dell'installazione vanno verificate separatamente.

Adatta il flusso alla tua azienda

Consulta la guida alla pianificazione dell'integrazione ERP. Puoi approfondire il perimetro previsto per lo sviluppo software su misura; possiamo valutare insieme il tuo processo attuale.

Parliamo delle tue esigenze →