alerts.beta
Background - API1Created with Sketch.

Códigos de Resposta HTTP

A API da Hotmart utiliza o padrão de códigos de resposta HTTP para indicar o sucesso ou falha de cada requisição. No caso de erros, além do código de resposta HTTP, enviamos também um objeto JSON com uma mensagem descritiva do erro e o seu tipo.

No geral, códigos no intervalo 2xx indicam sucesso.

Operações que resultam em um erro que ocorreu no lado do cliente (ex. token de acesso inválido) vão retornar um código no intervalo 4xx e indicam que a requisição está de alguma forma inválida. Se você receber um erro 4xx, recomendamos que leia o nosso glossário de erros para obter mais contexto para ajudá-lo a solucionar o problema.

Já os códigos de erros no intervalo 5xx sugerem um problema com os serviços da API da Hotmart.

Caso tenha dúvida ou não consiga resolver o seu problema, não hesite em contatar nosso time de suporte, se possível enviando a requisição completa que você está tentando fazer e o erro recebido. Assim nosso time poderá ajudá-lo a achar uma solução o mais rápido possível.

Retorno

  • errorstring

    O tipo de erro retornado. Pode ser um dos valores:

    invalid_token, token_expired, unauthorized, unauthorized_client, invalid_parameter, invalid_value_parameter, invalid_value_headers, not_found, too_many_requests ou internal_server_error.

  • error_descriptionstring

    Uma mensagem de fácil entendimento que fornece mais detalhes sobre o erro.

  • error_uristring

    Um link para nossa documentação onde poderá encontrar mais sobre o código de erro recebido.

Response
{
   "error": "unauthorized",
   "error_description": "Full authentication is required to access this resource."
   "error_uri": "https://developers.hotmart.com/docs/pt-BR/start/http-response-codes/"
}

Sumário de status HTTP

StatusTipo de erroDefinição
200 - OK-Código de sucesso. Tudo ocorreu como planejado.
201 - Created-Similar ao 200, porém se refere a um retorno quando um novo recurso foi criado.
400 - Bad Requestinvalid_parameterA requisição enviada está de alguma forma inválida.
invalid_value_parameterA requisição enviada está com o valor da queryString de alguma forma inválida.
invalid_value_headersA requisição enviada está com o valor do header de alguma forma inválida.
401 - UnauthorizedunauthorizedÉ necessário estar autenticado para prosseguir com a requisição. Esse erro normalmente ocorre quando o token de acesso não foi passado como parâmetro, ou há algum problema no nome do parâmetro passado no Header da requisição.
token_expiredO token de acesso passado como parâmetro expirou.
invalid_tokenO token de acesso passado como parâmetro está, de alguma forma, inválido.
403 - Forbiddenunauthorized_clientO usuário não possui permissões para prosseguir com a requisição.
404 - Not Foundnot_foundA URL requisitada não foi encontrada e está de alguma forma inválida.
429 - Too Many Requeststoo_many_requestsMuitas requisições foram feitas em um período curto de tempo. Para saber mais sobre nossos limites veja nossa seção de Rate Limit .
500 - Server Errorinternal_server_errorOcorreu algum erro interno não esperado e não foi possível completar a requisição.

isPageUseful.question