v1

API OmniraGO

Integre seus sistemas com a plataforma mais completa de gestão de licitações do Brasil.

Autenticação

A API OmniraGO utiliza JWT Bearer Token. Para autenticar, faça um POST /api/auth/login com suas credenciais e use o token retornado no header Authorization de todas as demais requisições.

POST /api/auth/login
curl -X POST https://api.omnirago.com.br/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"usuario@empresa.com","senha":"suaSenha"}'
Usando o token nas demais chamadas
curl https://api.omnirago.com.br/api/licitacoes \
  -H "Authorization: Bearer <seu_token_aqui>"

Tokens expiram em 24 horas. Após a expiração, repita o processo de autenticação para obter um novo token.

Endpoints Principais

Auth
Método Endpoint Descrição Auth
POST /api/auth/login Autenticar e obter JWT token Público
Licitações
Método Endpoint Descrição Auth
GET /api/licitacoes Listar licitações do tenant Bearer
GET /api/licitacoes/:id Obter licitação por ID Bearer
POST /api/licitacoes Criar nova licitação Bearer
Contratos
Método Endpoint Descrição Auth
GET /api/contratos Listar contratos Bearer
GET /api/contratos/:id Obter contrato por ID Bearer
Checklist
Método Endpoint Descrição Auth
GET /api/checklist/:licitacaoId Checklist de uma licitação Bearer
Dashboard
Método Endpoint Descrição Auth
GET /api/dashboard KPIs e resumo do tenant Bearer
Dados de Referência
Método Endpoint Descrição Auth
GET /api/orgaos Listar órgãos públicos Bearer
GET /api/modalidades Listar modalidades Bearer

Rate Limits

60
Requisições por minuto
Por token de acesso
1.000
Requisições por hora
Por conta
10 MB
Tamanho máximo de body
Por requisição
30s
Timeout
Por chamada

Ao exceder os limites, a API retorna HTTP 429 Too Many Requests com o header Retry-After indicando quantos segundos aguardar.

Postman Collection

Importe a collection completa no Postman com todos os endpoints, variáveis de ambiente e exemplos de body prontos para usar.

Baixar omnirago-api.json

Formato Postman Collection v2.1 · Compatível com Insomnia e Thunder Client