Pular para o conteúdo principal
A API da Tess AI usa códigos de resposta HTTP convencionais para indicar o sucesso ou a falha de uma requisição. Em geral:
  • Códigos na faixa 2xx indicam sucesso
  • Códigos na faixa 4xx indicam um erro causado pelas informações fornecidas
  • Códigos na faixa 5xx indicam um erro nos nossos servidores (esses são raros)

​
Códigos de Status HTTP

Código de StatusDescriçãoCausas Comuns
200Success - A requisição foi bem-sucedidaRequisição concluída conforme esperado
201Created - O recurso foi criado com sucessoNovo webhook criado com sucesso
400Bad Request - A requisição era inválidaCampos obrigatórios ausentes, valores de parâmetro inválidos
403Forbidden - Falha na autenticaçãoChave de API inválida, token expirado, permissões insuficientes
413Payload Too Large - O corpo da requisição excede o tamanho permitidoArquivo excede o tamanho máximo de upload
429Rate Limited - Muitas requisiçõesRate limits da API excedidos
500Internal Server Error - Problema no servidorErro inesperado no servidor (entre em contato com o suporte)

​
Tipos de Erros e Exemplos

​
Erros de Autenticação (403)

Esses erros ocorrem quando há um problema com sua chave de API: 
{
"error": "Invalid authentication"
}
Causas comuns:
  • Chave de API inválida
  • Chave de API expirada
  • Header de Authorization ausente
  • Permissões insuficientes

​
Erros de Validação (400)

Ocorrem quando os dados da requisição não atendem aos requisitos: 
{
"error": "Validation failed",
"messages": {
"url": ["The url field must be a valid HTTPS URL"],
"method": ["The method must be one of: POST, GET"]
}
}
Regras de validação comuns:
  • Webhooks
    • A URL deve ser uma URL HTTPS válida
    • O método deve ser POST ou GET
    • O status deve ser “active” ou “inactive”
  • Arquivos
    • O arquivo deve ser fornecido para upload
    • O flag de processamento é opcional (padrão: false)

​
Erros de Rate Limit (429)

Ocorrem quando você excedeu os rate limits da API: 
{
"error": "Rate limit exceeded",
"retry_after": 60
}

​
Erros de Servidor (500)

Indicam um problema no nosso lado: 
{
"error": "Internal server error"
}