alerts.beta
Background - API1Created with Sketch.

Sandbox

O sandbox é um ambiente que disponibilizamos para você testar sua integração enquanto ainda está em fase de desenvolvimento. Esse ambiente imita as características do ambiente de produção, então todos os endpoints disponibilizados no Hotmart Developers poderão ser acessados nele.

Recomendamos que utilize esse ambiente de teste para que o processo de desenvolvimento seja mais eficiente, já que com ele é possível identificar prováveis problemas de implementação antes do seu sistema ir ao ar.

A autenticação do sandbox vai ocorrer da mesma forma que a API da Hotmart, então você pode verificar como criar uma Credencial na seção de Autenticação da API . Além disso, os dados de retorno dos endpoints são todos fictícios, então sua conta e dados da Hotmart não serão afetados por nenhum teste realizado por eles.

A URL base do sandbox é https://sandbox.hotmart.com/ e todos os endpoints da API podem ser acessados por ela usando o caminho do endpoint original. Por exemplo: um endpoint qualquer da API que seja acessado pela URL:

https://developers.hotmart.com/payments/api/v1/subscriptions

Estaria disponível para teste no Sandbox na URL:

https://sandbox.hotmart.com/payments/api/v1/subscriptions

Alguns de nossos endpoints podem possuir mais de um cenário de resposta, sendo assim necessário o envio de valores específicos na requisição para que cada um desses cenários possa ser obtido e testado de forma isolada. Nestas situações, os possíveis valores de parâmetros e seus retornos estarão listados nas seções de cada um desses endpoints.

Retornos de Erro

Com o sandbox é possível testar prováveis erros da API da Hotmart, além do sucesso das requisições. Mas como a intenção principal desse ambiente é auxiliar no sucesso da sua integração, não disponibilizamos todos os erros que a API é capaz de retornar, já que somente algumas validações serão suficientes para testar sua implementação.

Na tabela abaixo temos exemplos de erros comuns que podem ser retornados em todos os endpoints, mas erros específicos serão listados dentro de cada seção dos endpoints.

StatusTipo de ErroDefinição
404 - Not Foundnot_foundA URL requisitada não foi encontrada e está de alguma forma inválida.
405 - Method Not Allowedmethod_not_allowedO método HTTP usado na requisição é conhecido pelo servidor, mas não pode ser usado nesse endpoint.
401 - Unauthorizedunauthorized_clientO usuário não possui permissões para prosseguir com a requisição.
500 - Server Errorinternal_server_errorOcorreu algum erro interno não esperado e não foi possível completar a requisição.

isPageUseful.question