Skip to main content
Este guia leva você do zero até uma validação de licença funcionando na sua aplicação. O processo completo leva menos de 10 minutos.
1

Crie sua conta

Acesse bluube.com e clique em Criar conta. Preencha seu e-mail e senha — nenhum cartão de crédito é necessário para começar com o plano gratuito.Após confirmar seu e-mail, você será redirecionado automaticamente para o dashboard.
2

Crie sua primeira aplicação

No dashboard, clique em Nova Aplicação. Preencha:
  • Nome: o nome do seu software (ex: Meu App Desktop)
  • Descrição (opcional): uma descrição curta para identificação interna
Clique em Criar. Sua aplicação será listada no dashboard com uma chave de API gerada automaticamente.Copie a chave de API — você vai precisar dela para autenticar todas as requisições à API da Bluube.
Nunca exponha sua chave de API em código-fonte público, repositórios Git ou qualquer lugar acessível a terceiros. Trate-a como uma senha. Se ela for comprometida, revogue-a imediatamente no dashboard.
3

Crie uma licença via API

Com sua chave de API em mãos, crie uma licença para um usuário fazendo uma requisição POST ao endpoint /licenses.Substitua sua_chave_de_api pela chave copiada no passo anterior e ajuste os campos conforme necessário.
curl --request POST \
  --url https://api.bluube.com/v1/licenses \
  --header "Authorization: Bearer sua_chave_de_api" \
  --header "Content-Type: application/json" \
  --data '{
    "label": "Usuário Exemplo",
    "type": "standard",
    "expires_at": "2026-12-31T23:59:59Z"
  }'
A resposta da API retorna os detalhes da licença criada, incluindo a chave que você vai distribuir ao usuário:
Resposta
{
  "id": "lic_7f3a2b9c4d1e8f06",
  "key": "BLUUBE-A1B2-C3D4-E5F6-G7H8",
  "label": "Usuário Exemplo",
  "type": "standard",
  "status": "active",
  "expires_at": "2026-12-31T23:59:59Z",
  "created_at": "2026-04-06T12:00:00Z"
}
O campo key (BLUUBE-A1B2-C3D4-E5F6-G7H8) é a chave que você entrega ao usuário final. Guarde o id para gerenciar essa licença no futuro.
Você também pode criar licenças diretamente pelo dashboard em Licenças → Nova Licença, sem precisar fazer chamadas à API.
4

Valide a licença na sua aplicação

Quando o usuário inserir a chave de licença no seu software, faça uma requisição POST ao endpoint /validate para verificar se ela é válida.
curl --request POST \
  --url https://api.bluube.com/v1/validate \
  --header "Authorization: Bearer sua_chave_de_api" \
  --header "Content-Type: application/json" \
  --data '{
    "key": "BLUUBE-A1B2-C3D4-E5F6-G7H8",
    "app_id": "app_9f3d2a1b"
  }'
Licença válida — a API retorna valid: true e os detalhes da licença:
Licença válida
{
  "valid": true,
  "license": {
    "id": "lic_7f3a2b9c4d1e8f06",
    "key": "BLUUBE-A1B2-C3D4-E5F6-G7H8",
    "type": "standard",
    "status": "active",
    "expires_at": "2026-12-31T23:59:59Z"
  }
}
Licença inválida ou expirada — a API retorna valid: false com o motivo:
Licença inválida
{
  "valid": false,
  "reason": "license_expired"
}
Use o campo valid para decidir se libera ou bloqueia o acesso na sua aplicação. Os valores possíveis para reason são license_not_found, license_expired, license_inactive e license_revoked.
Faça a validação sempre que o software for iniciado ou, em aplicações de longa duração, periodicamente (ex: a cada 24 horas). Isso garante que licenças revogadas ou expiradas sejam detectadas sem depender de verificações manuais.
5

Acompanhe o status no dashboard

Volte ao dashboard da Bluube e acesse Licenças na sua aplicação. Você verá a licença criada listada com status, data de expiração e histórico de validações.A partir do dashboard você pode:
  • Revogar uma licença imediatamente, impedindo novos acessos
  • Estender a data de expiração sem precisar criar uma nova chave
  • Filtrar por status (ativa, expirada, revogada) para auditar o uso
  • Exportar a lista de licenças em CSV para uso externo
Cada validação bem-sucedida é registrada com timestamp e identificador de sessão, dando visibilidade completa sobre quem está usando seu software.

​
Próximos passos

Conceitos

Entenda tipos de licença, expiração e trials em profundidade.

API Reference

Veja todos os endpoints disponíveis e seus parâmetros completos.

Gerenciar Licenças

Aprenda a criar, editar, revogar e exportar licenças em escala.

Integrar a API

Guias de integração para diferentes linguagens e plataformas.