Bet Fiscal
Início/Desenvolvedor

API — Documentação

Integre os dados do Bet Fiscal ao seu produto. A API REST está disponível em http://localhost:8000 em desenvolvimento.

Início rápido

# Verificar status da API
curl http://localhost:8000/health

# Consultar estatísticas
curl http://localhost:8000/api/v1/stats

# Submeter domínio para análise
curl -X POST http://localhost:8000/api/v1/domain/submit \
  -H "Content-Type: application/json" \
  -d '{"domain": "betexemplo.bet.br"}'
Base URL (desenvolvimento)http://localhost:8000
Formatoapplication/json
AutenticaçãoNenhuma (acesso aberto)
Health checkGET /health

Endpoints

GET/api/v1/stats

Estatísticas gerais da base

Resposta
{
  "total_domains": 1240,
  "irregular": 892,
  "legal": 215,
  "pendente": 133,
  "last_24h": 47
}
POST/api/v1/domain/submit

Submete um domínio para análise

Request body
{ "domain": "exemplo.bet.br" }
Resposta
{
  "domain": "exemplo.bet.br",
  "status": "LEGAL",
  "priority_score": 12.5,
  "fingerprint": {
    "ip": "104.21.0.1",
    "asn": "AS13335 Cloudflare",
    "cdn": "Cloudflare",
    "payment_gateways": ["pagbank", "mercadopago"]
  },
  "validation": {
    "is_authorized": true,
    "cnpj": "56.000.000/0001-00",
    "company_name": "EXEMPLO GAMING LTDA"
  }
}
GET/api/v1/domain/{domain}

Consulta resultado de um domínio já analisado

Resposta
{
  "domain": "exemplo.bet.br",
  "status": "LEGAL",
  "checked_at": "2026-05-05T18:00:00Z",
  "fingerprint": { ... },
  "validation": { ... }
}
GET/api/v1/domains

Lista domínios analisados recentemente

Parâmetroslimit=20, order=checked_at
Resposta
[
  { "domain": "...", "status": "IRREGULAR", "priority_score": 88.2, ... },
  ...
]
GET/api/v1/influencer/top

Ranking de influenciadores mais denunciados

Parâmetroslimit=3 (máx 50)
Resposta
[
  {
    "instagram_username": "exemplo",
    "complaint_count": 142,
    "full_name": "Nome Completo",
    "followers_count": 500000
  }
]
POST/api/v1/influencer/report

Denuncia um influenciador por promover apostas irregulares

Request body
{ "story_url": "https://www.instagram.com/stories/usuario/123456789/" }
Resposta
{ "reported": true, "username": "usuario" }
POST/api/v1/comprovante/report

Denuncia um recebedor de PIX via comprovante (imagem)

Request body
{ "image_base64": "data:image/jpeg;base64,..." }
Resposta
{
  "receiver_name": "NOME RECEBEDOR",
  "bank": "Banco XYZ",
  "pix_key": "00.000.000/0001-00",
  "amount": 150.00,
  "transaction_date": "2026-05-01"
}
GET/api/v1/comprovante/top

Ranking dos recebedores de PIX mais denunciados

Parâmetroslimit=5 (máx 100)
Resposta
[
  { "receiver_name": "...", "complaint_count": 38, "bank": "...", ... }
]

Códigos de status HTTP

CódigoDescrição
200OK — requisição bem-sucedida
202Accepted — domínio submetido para análise assíncrona
400Bad Request — dados inválidos ou domínio malformado
404Not Found — domínio não encontrado na base
503Service Unavailable — banco de dados indisponível

Valores de status

LEGAL

Empresa autorizada pela SPA/MF com domínio .bet.br registrado.

IRREGULAR

Site de apostas sem autorização da SPA/MF.

PENDENTE

Análise em andamento ou dados insuficientes para veredito.

Documentação interativa (Swagger)

Explore e teste todos os endpoints diretamente no browser via Swagger UI.

Abrir Swagger UI