🔐 Autenticação
Para consumir qualquer endpoint da API Predictus, você precisa primeiro gerar um token de acesso.A autenticação segue o padrão Bearer Token via HTTP Header.
🎯 Fluxo de Autenticação
Envie uma requisiçãoPOST para o endpoint /auth com seu username e password.Se as credenciais estiverem corretas, você receberá um
accessToken válido por 30 minutos (1800 segundos).
🔄 Endpoint
🧾 Body
📥 Exemplo de cURL
✅ Resposta esperada
📤 Utilizando o Token
Adicione o token no headerAuthorization das requisições:
🚫 Expiração e Erros
- O token é válido por 30 minutos
- Após a expiração, gere um novo token
- Não há refresh token
Códigos de erro
Limites de uso (429)
Toda requisição autenticada conta para a cota da sua credencial. Quando um limite é atingido, a API responde 429 Too Many Requests com um JSON que diz qual limite foi atingido:
As respostas com cota também trazem os headers abaixo, inclusive a recusada:
💡 Dica
Por segurança e performance, recomendamos que seu sistema implemente uma camada de cache do token com expiração automática.

