Autenticação da API de análises de sangue

Última atualização: 8 de setembro de 2026

Aprenda como autenticar suas requisições de API e gerenciar sua cota.

Visão Geral

A API Kantesti usa autenticação baseada em credenciais. Cada requisição de API deve incluir seu nome de usuário e senha no corpo da requisição.

Método de Autenticação

As credenciais são enviadas como form-data ou corpo JSON em cada requisição. Não são necessárias chaves de API ou tokens.

Credenciais da API

Suas credenciais da API consistem em:

Campo	Tipo	Descrição
`username`	string	Seu nome de usuário único da API
`password`	string	Sua senha segura da API

Formato da Requisição

Inclua suas credenciais em cada requisição 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 Práticas de Segurança

Diretrizes de Segurança

Nunca exponha credenciais em código do lado do cliente
Use variáveis de ambiente para armazenar credenciais
Sempre use HTTPS - todas as requisições são criptografadas
Altere a senha periodicamente para maior segurança

Gerenciamento de Cota

Cada conta tem uma cota de API (créditos). Cada requisição de produção bem-sucedida consome 1 crédito.

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 Autenticação

Código	Mensagem	Solução
`AUTH_1001`	Credenciais de autenticação ausentes	Inclua usuário e senha
`AUTH_1002`	Usuário ou senha inválidos	Verifique suas credenciais
`AUTH_1003`	Conta temporariamente bloqueada	Aguarde ou entre em contato com o suporte

Próximos Passos

Endpoints da API - Explore todos os endpoints disponíveis
Limites de Taxa - Entenda o gerenciamento de cota
Códigos de Erro - Referência completa de erros