Cosa significano i codici di errore HTTP come 400, 401, 403, 404, 429, 500, 502 e 503?
I codici di stato HTTP sono risposte standardizzate utilizzate da servizi web e API.
Potresti incontrare questi codici mentre utilizzi Polyosync, risolvendo un'integrazione o esaminando informazioni tecniche sugli errori.
Il significato di un codice di stato è generale. La sua causa specifica dipende dalla richiesta e dal servizio che lo ha restituito.
400 — Richiesta non valida
Il server non è riuscito a elaborare la richiesta perché le informazioni inviate erano non valide o non soddisfacevano i requisiti attesi.
Controlla l'input e la configurazione della richiesta.
401 — Non autorizzato
La richiesta manca di un'autenticazione valida.
Controlla se l'autorizzazione della sessione o dell'integrazione pertinente è valida.
403 — Vietato
Il server ha compreso la richiesta ma non consente l'azione richiesta.
Esamina le autorizzazioni applicabili e le restrizioni di accesso.
404 — Non trovato
La risorsa richiesta non è stata trovata.
Verifica il riferimento alla risorsa, l'URL e il contesto dello spazio di lavoro.
429 — Troppe richieste
Il servizio sta limitando le richieste perché è stato raggiunto un limite di tasso applicabile.
Evita di inviare ripetutamente la stessa richiesta. Controlla eventuali indicazioni specifiche del fornitore su quando le richieste possono essere ripetute.
500 — Errore interno del server
Il servizio ha riscontrato una condizione imprevista durante l'elaborazione della richiesta.
Questo non identifica, di per sé, la causa sottostante.
502 — Bad Gateway
Un servizio che funge da gateway ha ricevuto una risposta non valida da un servizio upstream.
Questo può indicare un problema che coinvolge un servizio dipendente.
503 — Servizio non disponibile
Il servizio è temporaneamente incapace di gestire la richiesta.
Le cause possibili includono indisponibilità temporanea, sovraccarico o manutenzione.
504 — Timeout del gateway
Un gateway non ha ricevuto una risposta tempestiva da un servizio upstream.
Questo può verificarsi quando un'operazione dipendente richiede troppo tempo.
Distinzioni importanti
Un errore 401 non significa necessariamente che il tuo account sia stato eliminato.
Un errore 403 non significa necessariamente che la piattaforma non funzioni; l'accesso potrebbe essere intenzionalmente limitato.
Un errore 404 non prova che una risorsa non sia mai esistita.
Un errore della serie 500 non identifica automaticamente Polyosync come il componente difettoso; la risposta può provenire da un servizio esterno.
Cosa dovrei fare?
Registra il codice di stato esatto, l'operazione che lo ha prodotto, l'ora approssimativa e il servizio interessato.
Se l'operazione potrebbe aver modificato i dati aziendali, verifica il suo risultato prima di riprovare.
Quando contattare il supporto
Fornisci il codice di stato insieme al contesto completo.
Un codice numerico da solo è raramente sufficiente per determinare la causa principale.