Autenticacao

Aprenda como autenticar suas requisicoes de API e gerenciar sua cota.

Visao Geral

A API Kantesti usa autenticacao baseada em credenciais. Cada requisicao de API deve incluir seu nome de usuario e senha no corpo da requisicao.

Metodo de Autenticacao

As credenciais sao enviadas como form-data ou corpo JSON em cada requisicao. Nao sao necessarias chaves de API ou tokens.

Credenciais da API

Suas credenciais da API consistem em:

Campo	Tipo	Descricao
`username`	string	Seu nome de usuario unico da API
`password`	string	Sua senha segura da API

Formato da Requisicao

Inclua suas credenciais em cada requisicao de API:

Form Data (Multipart)

curl -X POST "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze" \
  -F "username=SEU_USUARIO" \
  -F "password=SUA_SENHA" \
  -F "language=pt" \
  -F "file=@exame_sangue.pdf"

Corpo JSON (para alguns endpoints)

curl -X POST "https://app.aibloodtestinterpret.com/api/quota/check" \
  -H "Content-Type: application/json" \
  -d '{"username": "SEU_USUARIO", "password": "SUA_SENHA"}'

Boas Praticas de Seguranca

Diretrizes de Seguranca

Nunca exponha credenciais em codigo do lado do cliente
Use variaveis de ambiente para armazenar credenciais
Sempre use HTTPS - todas as requisicoes sao criptografadas
Altere a senha periodicamente para maior seguranca

Gerenciamento de Cota

Cada conta tem uma cota de API (creditos). Cada requisicao de producao bem-sucedida consome 1 credito.

Verificar Sua Cota

curl -X POST "https://app.aibloodtestinterpret.com/api/quota/check" \
  -H "Content-Type: application/json" \
  -d '{"username": "SEU_USUARIO", "password": "SUA_SENHA"}'

Erros de Autenticacao

Codigo	Mensagem	Solucao
`AUTH_1001`	Credenciais de autenticacao ausentes	Inclua usuario e senha
`AUTH_1002`	Usuario ou senha invalidos	Verifique suas credenciais
`AUTH_1003`	Conta temporariamente bloqueada	Aguarde ou entre em contato com o suporte

Proximos Passos

Endpoints da API - Explore todos os endpoints disponiveis
Limites de Taxa - Entenda o gerenciamento de cota
Codigos de Erro - Referencia completa de erros