Autenticacao¶

A API da OODA Intelligence utiliza JSON Web Tokens (JWT) para autenticacao. Todos os endpoints (exceto login) requerem um token valido.

Obtendo um Token¶

Request¶

curl -X POST https://dashboard.oodaintel.com/api/v1/auth/token/ \
  -H "Content-Type: application/json" \
  -d '{
    "username": "seu_usuario",
    "password": "sua_senha"
  }'

Response¶

{
  "access": "eyJ0eXAiOiJKV1QiLCJhbGci...",
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGci..."
}

Validade dos Tokens

Access token: 30 minutos
Refresh token: 7 dias

Usando o Token¶

Inclua o token no header Authorization de todas as requisicoes:

curl -X GET https://dashboard.oodaintel.com/api/v1/monitoring/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGci..."

Renovando o Token¶

Quando o access token expirar, use o refresh token para obter um novo:

cURLPythonJavaScript

curl -X POST https://dashboard.oodaintel.com/api/v1/auth/token/refresh/ \
  -H "Content-Type: application/json" \
  -d '{
    "refresh": "eyJ0eXAiOiJKV1QiLCJhbGci..."
  }'

import requests

response = requests.post(
    "https://dashboard.oodaintel.com/api/v1/auth/token/refresh/",
    json={"refresh": refresh_token}
)
new_access = response.json()["access"]

const response = await fetch(
  'https://dashboard.oodaintel.com/api/v1/auth/token/refresh/',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ refresh: refreshToken })
  }
);
const { access } = await response.json();

Rate Limiting¶

Os limites de requisicoes variam conforme o plano:

Plano	Limite
Starter	100 req/min
Professional	500 req/min
Enterprise	2.000 req/min

Excedendo o Limite

Ao exceder o rate limit, a API retorna status 429 Too Many Requests com o header Retry-After indicando quando tentar novamente.

Multi-tenant¶

Todos os dados retornados pela API sao automaticamente filtrados pela organizacao do usuario autenticado. Nao e possivel acessar dados de outras organizacoes.