Case Codigos Erros Web

Area_Ferramentas

Ao conectar em outros serviços, sejam serviços e sistemas da própria Touch Comp ou serviços de Terceiros, podem ocorrer falhas de ambos os lados, tanto no servidor quanto na aplicação cliente. Esses erros possuem códigos únicos e validos para qualquer aplicação ou sistema em todo o mundo, não sendo exclusividade dos produtos da Touch Comp. Observe que denotam erros padrões, onde o responsável pelo serviço pode criar outros tópicos de erros, com mensagens mais claras e objetivas.

Considere como exemplos de aplicações:

• Aplicação servidora: Touch Comp API/WEB
• Aplicação Cliente: Touch Comp Mobile, Touch Comp NFCe, Web Receita, Sefaz(Webservices)

Mensagens de erro - Lado da aplicação servidor

Estes erros acontecem no servidor. Logo você deve verificar logs de erros, depurar o servidor para encontrar as causas do problema. A título de exemplo, estes erros acontecem no Touch Comp API/WEB.

Chamamos a atenção para os principais erros:

• 500 =(Internal Server Error) => Ocorreu um erro no servidor. Verifique o log de erros do Widlfly, Docker, etc, para verificar a causa do problema.

• 500 =(Internal Server Error) O servidor encontrou um erro. Verifique o log no servidor ou consulte responsável pelo servidor
• 501 =(Not Implemented) O método da requisição não é suportado pelo servidor e não pode ser manipulado.
• 502 =(Bad Gateway) Esta resposta de erro significa que o servidor, ao trabalhar como um gateway a fim de obter uma resposta necessária para manipular a requisição, obteve uma resposta inválida.
• 503 =(Service Unavailable) O servidor não está pronto para manipular a requisição. Causas comuns são um servidor em manutenção ou sobrecarregado. Note que junto a esta resposta, uma página amigável explicando o problema deveria ser enviada. Estas respostas devem ser usadas para condições temporárias e o cabeçalho HTTP Retry-After: deverá, se posível, conter o tempo estimado para recuperação do serviço. O webmaster deve também tomar cuidado com os cabaçalhos relacionados com o cache que são enviados com esta resposta, já que estas respostas de condições temporárias normalmente não deveriam ser postas em cache.
• 504 =(Gateway Timeout) Esta resposta de erro é dada quando o servidor está atuando como um gateway e não obtém uma resposta a tempo.
• 505 =(HTTP Version Not Supported) A versão HTTP usada na requisição não é suportada pelo servidor.
• 506 =(Variant Also Negotiates) O servidor tem um erro de configuração interno: a negociação transparente de conteúdo para a requisição resulta em uma referência circular.
• 507 =(Insufficient Storage) O servidor tem um erro interno de configuração: o recurso variante escolhido está configurado para entrar em negociação transparente de conteúdo com ele mesmo, e portanto não é uma ponta válida no processo de negociação.
• 508 =(Loop Detected (WebDAV (en-US))) O servidor detectou um looping infinito ao processar a requisição.
• 510 =(Not Extended) Exigem-se extenções posteriores à requisição para o servidor atendê-la.
• 511 =(Network Authentication) Required O código de status 511 indica que o cliente precisa se autenticar para ganhar acesso à rede.

Mensagens de erro - Lado da aplicação cliente

Estes erros ocorrem pelo lado da aplicação, considere neste caso conforme exemplo anterior, o Touch Comp Mobile. Esses erros indicam algum problema de configuração entre aplicação e cliente e aplicação servidora. Chamamos a atenção para os erros com mais frequência:

• 404= (Not Found) => O serviço/URL não existe no servidor, onde a aplicação cliente/servidor estão em versões diferentes, ou configuradas erroneamente. Verifique se a aplicação está sendo executada no servidor e está na mesma versão e é compatível com a versão da aplicação cliente. A titulo de exemplo, foi atualizado a aplicação cliente(20210701) e não foi atualizado a versão no servidor, que se encontra ainda em uma versão antiga (20210601).
• 401= (Unauthorized) e 403= (Forbidden) => Você não tem acesso a aplicação servidora. Verifique suas credenciais, certificados digitais se aplicáveis, etc.
• Conection Refused => Neste caso o servidor negou a requisição. Muito provavelmente não está sendo executado a aplicação servidor, Docker/Wildfy estão parados por exemplo.

Certifique-se que os servidor está rodando. Reinicie os serviços, para atestar que não estão travados
Outro problema são bloqueios de serviços, firewall, proxy, etc. Verifique se o endereço não está bloqueado. Informe a URL  em outra máquina, fora da empresa onde o problema está acontecendo para confirmar. 
Se o serviço está instalado localmente em determinado servidor, verifique se localmente consegue abrir no mesmo, usando http://localhost. Se sim, existe um bloqueio.
Se instalou o wildfly manualmente, instale utilizando nosso instalador. Confira as configurações em Case_Wildfly.

• 400= (Bad Request) Essa resposta significa que o servidor não entendeu a requisição pois está com uma sintaxe inválida.
• 401= (Unauthorized) Embora o padrão HTTP especifique "unauthorized", semanticamente, essa resposta significa "unauthenticated". Ou seja, o cliente deve se autenticar para obter a resposta solicitada.
• 402= (Payment Required) Este código de resposta está reservado para uso futuro. O objetivo inicial da criação deste código era usá-lo para sistemas digitais de pagamento porém ele não está sendo usado atualmente.
• 403= (Forbidden) O cliente não tem direitos de acesso ao conteúdo portanto o servidor está rejeitando dar a resposta. Diferente do código 401, aqui a identidade do cliente é conhecida.
• 404= (Not Found) O servidor não pode encontrar o recurso solicitado. Este código de resposta talvez seja o mais famoso devido à frequência com que acontece na web.
• 405= (Method Not Allowed) O método de solicitação é conhecido pelo servidor, mas foi desativado e não pode ser usado. Os dois métodos obrigatórios, GET e HEAD, nunca devem ser desabilitados e não devem retornar este código de erro.
• 406= (Not Acceptable) Essa resposta é enviada quando o servidor da Web após realizar a negociação de conteúdo orientada pelo servidor, não encontra nenhum conteúdo seguindo os critérios fornecidos pelo agente do usuário.
• 407= (Proxy Authentication Required) Semelhante ao 401 porem é necessário que a autenticação seja feita por um proxy.
• 408= (Request Timeout) Esta resposta é enviada por alguns servidores em uma conexão ociosa, mesmo sem qualquer requisição prévia pelo cliente. Ela significa que o servidor gostaria de derrubar esta conexão em desuso. Esta resposta é muito usada já que alguns navegadores, como Chrome, Firefox 27+, ou IE9, usam mecanismos HTTP de pré-conexão para acelerar a navegação. Note também que alguns servidores meramente derrubam a conexão sem enviar esta mensagem.
• 409= (Conflict) Esta resposta será enviada quando uma requisição conflitar com o estado atual do servidor.
• 410= (Gone) Esta resposta será enviada quando o conteúdo requisitado foi permanentemente deletado do servidor, sem nenhum endereço de redirecionamento. É experado que clientes removam seus caches e links para o recurso. A especificação HTTP espera que este código de status seja usado para "serviços promocionais de tempo limitado". APIs não devem se sentir obrigadas a indicar que recursos foram removidos com este código de status.
• 411= (Length Required) O servidor rejeitou a requisição porque o campo Content-Length do cabeçalho não está definido e o servidor o requer.
• 412= (Precondition Failed) O cliente indicou nos seus cabeçalhos pré-condições que o servidor não atende.
• 413= (Payload Too Large) A entidade requisição é maior do que os limites definidos pelo servidor; o servidor pode fechar a conexão ou retornar um campo de cabeçalho Retry-After.
• 414= (URI Too Long) A URI requisitada pelo cliente é maior do que o servidor aceita para interpretar.
• 415= (Unsupported Media Type) O formato de mídia dos dados requisitados não é suportado pelo servidor, então o servidor rejeita a requisição.
• 416= (Requested Range Not Satisfiable) O trecho especificado pelo campo Range do cabeçalho na requisição não pode ser preenchido; é possível que o trecho esteja fora do tamanho dos dados da URI alvo.
• 417= (Expectation Failed) Este código de resposta significa que a expectativa indicada pelo campo Expect do cabeçalho da requisição não pode ser satisfeita pelo servidor.
• 418= (I'm a teapot) O servidor recusa a tentativa de coar café num bule de chá.
• 421= (Misdirected Request) A requisição foi direcionada a um servidor inapto a produzir a resposta. Pode ser enviado por um servidor que não está configurado para produzir respostas para a combinação de esquema ("scheme") e autoridade inclusas na URI da requisição.
• 422= (Unprocessable Entity (WebDAV (en-US))) A requisição está bem formada mas inabilitada para ser seguida devido a erros semânticos.
• 423= (Locked (WebDAV (en-US))) O recurso sendo acessado está travado.
• 424= (Failed Dependency (WebDAV (en-US))) A requisição falhou devido a falha em requisição prévia.
• 425= (Too Early) Indica que o servidor não está disposto a arriscar processar uma requisição que pode ser refeita.
• 426= (Upgrade Required) O servidor se recusa a executar a requisição usando o protocolo corrente mas estará pronto a fazê-lo após o cliente atualizar para um protocolo diferente. O servidor envia um cabeçalho Upgrade numa resposta 426 para indicar o(s) protocolo(s) requeridos.
• 428= (Precondition Required) O servidor de origem requer que a resposta seja condicional. Feito para prevenir o problema da 'atualização perdida', onde um cliente pega o estado de um recurso (GET) , modifica-o, e o põe de volta no servidor (PUT), enquanto um terceiro modificou o estado no servidor, levando a um conflito.
• 429= (Too Many Requests) O usuário enviou muitas requisições num dado tempo ("limitação de frequência").
• 431= (Request Header Fields Too Large) O servidor não quer processar a requisição porque os campos de cabeçalho são muito grandes. A requisição PODE ser submetida novemente depois de reduzir o tamanho dos campos de cabeçalho.
• 451= (Unavailable For Legal Reasons) O usuário requisitou um recurso ilegal, tal como uma página censurada por um governo.

Mensagens Erros- Redirecionamento

Estes erros acontecem raramente, e estão relacionados a mudanças principalmente do lado do servidor.

• 300 =(Multiple Choice) A requisição tem mais de uma resposta possível. User-agent ou o user deve escolher uma delas. Não há maneira padrão para escolher uma das respostas.
• 301 =(Moved Permanently) Esse código de resposta significa que a URI do recurso requerido mudou. Provavelmente, a nova URI será especificada na resposta.
• 302 =(Found) Esse código de resposta significa que a URI do recurso requerido foi mudada temporariamente. Novas mudanças na URI poderão ser feitas no futuro. Portanto, a mesma URI deve ser usada pelo cliente em requisições futuras.
• 303 =(See Other) O servidor manda essa resposta para instruir ao cliente buscar o recurso requisitado em outra URI com uma requisição GET.
• 304 =(Not Modified) Essa resposta é usada para questões de cache. Diz ao cliente que a resposta não foi modificada. Portanto, o cliente pode usar a mesma versão em cache da resposta.
• 305 =(Use Proxy) Foi definida em uma versão anterior da especificação HTTP para indicar que uma resposta deve ser acessada por um proxy. Foi depreciada por questões de segurança em respeito a configuração em banda de um proxy.
• 306 =(unused) Esse código de resposta não é mais utilizado, encontra-se reservado. Foi usado numa versão anterior da especificação HTTP 1.1.
• 307 =(Temporary Redirect) O servidor mandou essa resposta direcionando o cliente a buscar o recurso requisitado em outra URI com o mesmo método que foi utilizado na requisição original. Tem a mesma semântica do código 302 Found, com a exceção de que o user-agent não deve mudar o método HTTP utilizado: se um POST foi utilizado na primeira requisição, um POST deve ser utilizado na segunda.
• 308 =(Permanent Redirect) Esse código significa que o recurso agora está permanentemente localizado em outra URI, especificada pelo cabeçalho de resposta Location. Tem a mesma semântica do código de resposta HTTP 301 Moved Permanently com a exceção de que o user-agent não deve mudar o método HTTP utilizado: se um POST foi utilizado na primeira requisição, um POST deve ser utilizado na segunda.

Mensagens Informativas - Sucesso

Geralmente, os sistemas não demonstram tais mensagens, quando a conexão e o processo ocorreu bem, sendo internas e implícitas. Aqui são demonstradas a título de informação.

• 200 =(OK) Estas requisição foi bem sucedida. O significado do sucesso varia de acordo com o método HTTP:
• 201 =(Created) A requisição foi bem sucedida e um novo recurso foi criado como resultado. Esta é uma tipica resposta enviada após uma requisição POST.
• 202 =(Accepted) A requisição foi recebida mas nenhuma ação foi tomada sobre ela. Isto é uma requisição não-comprometedora, o que significa que não há nenhuma maneira no HTTP para enviar uma resposta assíncrona indicando o resultado do processamento da solicitação. Isto é indicado para casos onde outro processo ou servidor lida com a requisição, ou para processamento em lote.
• 203 =(Non-Authoritative) Information Esse código de resposta significa que o conjunto de meta-informações retornadas não é o conjunto exato disponível no servidor de origem, mas coletado de uma cópia local ou de terceiros. Exceto essa condição, a resposta de 200 OK deve ser preferida em vez dessa resposta.
• 204 =(No Content) Não há conteúdo para enviar para esta solicitação, mas os cabeçalhos podem ser úteis. O user-agent pode atualizar seus cabeçalhos em cache para este recurso com os novos.
• 205 =(Reset Content) Esta requisição é enviada após realizanda a solicitação para informar ao user agent redefinir a visualização do documento que enviou essa solicitação.
• 206 =(Partial Content) Esta resposta é usada por causa do cabeçalho de intervalo enviado pelo cliente para separar o download em vários fluxos.
• 207 =(Multi-Status (WebDAV (en-US))) Uma resposta Multi-Status transmite informações sobre vários recursos em situações em que vários códigos de status podem ser apropriados.
• 208 =(Multi-Status (WebDAV (en-US))) Usado dentro de um elemento de resposta <dav:propstat> para evitar enumerar os membros internos de várias ligações à mesma coleção repetidamente.
• 226 =(IM Used (HTTP Delta encoding)) O servidor cumpriu uma solicitação GET para o recurso e a resposta é uma representação do resultado de uma ou mais manipulações de instância aplicadas à instância atual.
• 100 =(Continue) Essa resposta provisória indica que tudo ocorreu bem até agora e que o cliente deve continuar com a requisição ou ignorar se já concluiu o que gostaria.
• 101 =(Switching Protocol) Esse código é enviado em resposta a um cabeçalho de solicitação Upgrade pelo cliente, e indica o protocolo a que o servidor está alternando.
• 102 =(Processing (WebDAV (en-US))) Este código indica que o servidor recebeu e está processando a requisição, mas nenhuma resposta está disponível ainda.
• 103 =(Early Hints) Este código tem principalmente o objetivo de ser utilizado com o cabeçalho Link, indicando que o agente deve iniciar a pré-carregar recursos enquanto o servidor prepara uma resposta.