Licensing Central API Pública

Licenças, chaves e validação para projetos em escala

Esta central entrega a camada de licenciamento para múltiplos projetos, domínios e bots. Ela não replica a API oficial do WhatsApp, mas fornece a base profissional para você controlar acesso, expiração, revogação, auditoria e escopo de uso em cima da sua infraestrutura.

Basehttps://licensing.mago-bot.com
Admin/admin
Docs técnicas/docs
Health/health

Fluxo recomendado

1. Criar projetoRegistra domínio, nome e slug
2. Emitir chaveGera token com expiração e scopes
3. Validar no clienteO projeto consulta a central antes de usar a API
4. Revogar a qualquer momentoBloqueia acesso imediato

Endpoints principais

GET /v1/infoCatálogo público da API
POST /v1/projectsCria um projeto
GET /v1/projectsLista projetos
POST /v1/keysEmite uma chave
POST /v1/keys/validateValida a chave do cliente
POST /v1/keys/<id>/revokeRevoga acesso

Autenticação

Operações administrativas exigem o cabeçalho x-admin-token. A validação do cliente usa apenas a chave do projeto. 

curl -X POST https://licensing.mago-bot.com/v1/keys   -H "Content-Type: application/json"   -H "x-admin-token: SUA_CHAVE_ADMIN"   -d '{"label":"Projeto X","project_slug":"projeto-x","scopes":["whatsapp:connect"]}'

Exemplo de validação

curl -X POST https://licensing.mago-bot.com/v1/keys/validate   -H "Content-Type: application/json"   -d '{"token":"SUA_CHAVE","project_slug":"projeto-x","scope":"whatsapp:connect"}'

Modelo de dados

Projectid, name, slug, domain, is_active
Licenseid, uuid, label, token hash, scopes, status, expires_at, revoked_at, last_used_at
Audit logaction, actor, IP, payload, timestamps