O que significam os códigos de errore HTTP, como 400, 401, 403, 404, 429, 500, 502 e 503?
Os códigos de status HTTP são respostas padronizadas usadas por serviços web e APIs.
Você pode encontrar esses códigos ao usar o Polyosync, solucionando uma integração ou revisando informações técnicas sobre erros.
O significado de um código de status é geral. Sua causa específica depende da solicitação e do serviço que o retornou.
400 — Solicitação inválida
O servidor não conseguiu processar a solicitação porque as informações enviadas eram inválidas ou não atendiam aos requisitos esperados.
Verifique a entrada e a configuração da solicitação.
401 — Não autorizado
A solicitação carece de autenticação válida.
Verifique se a autorização da sessão ou da integração relevante é válida.
403 — Proibido
O servidor entendeu a solicitação, mas não permite a ação solicitada.
Revise as permissões aplicáveis e as restrições de acesso.
404 — Não encontrado
O recurso solicitado não pôde ser encontrado.
Verifique a referência do recurso, a URL e o contexto do espaço de trabalho.
429 — Muitas solicitações
O serviço está limitando solicitações porque um limite de taxa aplicável foi atingido.
Evite enviar repetidamente a mesma solicitação. Revise qualquer orientação específica do provedor sobre quando as solicitações podem ser reexperimentadas.
500 — Erro interno do servidor
O serviço encontrou uma condição inesperada ao processar a solicitação.
Isso não identifica, por si só, a causa subjacente.
502 — Gateway inválido
Um serviço que atua como um gateway recebeu uma resposta inválida de um serviço upstream.
Isso pode indicar um problema envolvendo um serviço dependente.
503 — Serviço indisponível
O serviço está temporariamente incapaz de lidar com a solicitação.
As causas possíveis incluem indisponibilidade temporária, sobrecarga ou manutenção.
504 — Tempo limite do gateway
Um gateway não recebeu uma resposta em tempo hábil de um serviço upstream.
Isso pode ocorrer quando uma operação dependente leva muito tempo.
Distinções importantes
Um erro 401 não significa necessariamente que sua conta foi excluída.
Um erro 403 não significa necessariamente que a plataforma está com problemas; o acesso pode ser intencionalmente restrito.
Um erro 404 não prova que um recurso nunca existiu.
Um erro da série 500 não identifica automaticamente o Polyosync como o componente com falha; a resposta pode vir de um serviço externo.
O que devo fazer?
Registre o código de status exato, a operação que o produziu, a hora aproximada e o serviço afetado.
Se a operação pode ter modificado dados comerciais, verifique seu resultado antes de tentar novamente.
Quando entrar em contato com o suporte
Forneça o código de status junto com o contexto completo.
Um código numérico sozinho raramente é suficiente para determinar a causa raiz.