Uma licença é a unidade central de controle de acesso na Bluube. Ela representa a permissão concedida a um usuário para utilizar sua aplicação, e pode ser configurada com expiração, limites de ativação e tipos personalizados conforme seu modelo de negócio.
Tipos de licença
| Tipo | Descrição |
|---|
permanent | Licença sem data de expiração. O acesso é concedido por tempo indeterminado. |
time_limited | Licença com data de expiração definida. Após a data, o status muda para expired. |
trial | Licença de avaliação com duração reduzida, ideal para onboarding de novos usuários. |
custom | Tipo personalizável para casos como licenças baseadas em funcionalidades ou uso. |
Use licenças do tipo trial para permitir que novos usuários experimentem sua aplicação sem precisar de pagamento antecipado. Você define a duração do trial diretamente no dashboard ou via API.
Campos da licença
| Campo | Tipo | Descrição |
|---|
key | string | Identificador único da licença, gerado automaticamente pela Bluube. |
status | string | Estado atual da licença: active, expired ou suspended. |
type | string | Tipo da licença: permanent, time_limited, trial ou custom. |
expiration_date | string (ISO 8601) | Data de expiração. Presente apenas em licenças time_limited e trial. |
max_activations | integer | Número máximo de dispositivos ou instâncias que podem ativar essa licença. |
app_id | string | Identificador da aplicação à qual essa licença pertence. |
Ciclo de vida de uma licença
Toda licença na Bluube passa por um ciclo de vida bem definido:
criada → ativada → expirada / suspensa / revogada
- Criada: a licença é gerada no dashboard ou via API e fica disponível para ser distribuída ao usuário.
- Ativada: o usuário utiliza a chave em sua aplicação. A Bluube registra a ativação e valida os limites definidos.
- Expirada: a data de expiração foi atingida. A licença deixa de ser válida automaticamente.
- Suspensa: você suspendeu manualmente a licença. Ela pode ser reativada a qualquer momento.
- Revogada: a licença foi revogada permanentemente e não pode mais ser utilizada.
Exemplo de licença via API
{
"key": "BLUUBE-XXXX-YYYY-ZZZZ",
"status": "active",
"type": "time_limited",
"expiration_date": "2026-12-31T23:59:59Z",
"max_activations": 3,
"app_id": "app_abc123"
}