Equipe Quickex

1 de setembro de 2025

~1 min de leitura

2xx Successo

4xx Erro do Cliente

5xx Erro do Servidor

Quickex utiliza códigos HTTP padrão para indicar o resultado da requisição:
2xx — sucesso,
4xx — erro nos dados/permissões da requisição,
5xx — erro do lado do servidor (raramente).

Alguns códigos 4xx contêm um breve
error.code e uma mensagem para processamento programático.

Recomendações de tratamento

Registre HTTP status e o corpo da resposta.
Para 429 e erros temporários 5xx use repetição com pausa exponencial (backoff + jitter).
Verifique os parâmetros obrigatórios antes de enviar a requisição.

Código	Nome	Descrição
200	OK	Tudo funcionou como esperado.
400	Bad Request	Requisição incorreta (frequentemente falta um parâmetro obrigatório).
401	Unauthorized	Token/chave inválido ou ausente.
402	Request Failed	Os parâmetros estão corretos, mas a operação não foi realizada.
403	Forbidden	Permissões insuficientes para realizar a requisição.
404	Not Found	O recurso não existe.
409	Conflict	Conflito com o estado atual (duplicação, inconsistência, etc.).
424	External Dependency Failed	Falha em uma dependência externa, impedindo a execução da requisição.
429	Too Many Requests	Limite excedido — reduza a frequência, utilize backoff.
500, 502, 503, 504	Erros do Servidor	Erro do lado do servidor. Tente novamente mais tarde (com backoff).

Resumo informativo

Quickex utiliza códigos HTTP padrão. 2xx — sucesso; 4xx — erros de validação/permissões/cliente; 5xx — erros do servidor (raramente). Códigos 4xx processáveis contêm código de erro e mensagem. Para 429 e 5xx temporários, utilize backoff exponencial com jitter. Sempre registre o status e o corpo da resposta.

Compartilhe este artigo:

Erros