Skip to main content

​
🔐 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ção POST 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

POST https://api.predictus.com.br/auth

​
🧾 Body

{
  "username": "SEU_USERNAME",
  "password": "SEU_PASSWORD"
}

​
📥 Exemplo de cURL

curl --location 'https://api.predictus.com.br/auth' \
--header 'Content-Type: application/json' \
--data '{
  "username": "SEU_USERNAME",
  "password": "SEU_PASSWORD"
}'

​
✅ Resposta esperada

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 1800,
  "tokenType": "bearer"
}

​
📤 Utilizando o Token

Adicione o token no header Authorization das requisições: 
Authorization: Bearer {accessToken}

​
🚫 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

CódigoSignificadoPossível ação
401Credenciais inválidasVerifique username e password

​
💡 Dica

Por segurança e performance, recomendamos que seu sistema implemente uma camada de cache do token com expiração automática.