HTTP Status Codes

A Clicksign segue o padrão de HTTP Status Codes. Os erros na faixa 4xx ocorrem quando há algo errado na requisição enviada pelo cliente para a Clicksign. Já os erros na faixa 5xx são erros inesperados que ocorrem nos servidores da Clicksign.

Sobre as mensagens de erro

Seguindo a especificação JSONAPI, todas as mensagens de erro incluirão detalhes no corpo da resposta, fornecendo code, status, title, detail, e, quando necessário, source.

4×× Client Error

Sempre verifique o BODY da resposta, o retorno da requisição mostrará o motivo pelo qual a requisição não foi aceita pelos servidores da Clicksign.

Exemplos de retorno de requisição inválida

{
  "errors": [
    {
      "code": "bad_request",
      "status": 400,
      "source": {
        "pointer": "/data/attributes/filename"
      },
      "detail": "filename deve ser informado(a)"
    }
  ]
}

{
  "errors": [
    {
      "code": "unauthorized",
      "status": 401,
      "title": "Não autorizado",
      "detail": "Access Token inválido"
    }
  ]
}

5×× Server Error

A Clicksign possui sistema de monitoramento de erros 500.

Suporte da Clicksign

Se você estiver com problemas relacionados à integração, entre em contato conosco através do e-mail [email protected] com o máximo de detalhes possível. Informações que nos ajudam a debugar a sua requisição:

- Ambiente: sandbox ou produção
- Conta
- E-mail do operador
- Path da requisição
- Método da requisição
- Código HTTP de erro
- JSON enviado
- JSON recebido
- Key do documento
- E-mails contidos na lista de assinatura
- Horário da requisição
- IP de origem
- Print screen