A validação é o processo pelo qual sua aplicação verifica se uma chave de licença é legítima e está autorizada a ser usada. A Bluube oferece validação em tempo real via API REST, com resposta imediata sobre o estado da licença.
Como funciona a validação
O fluxo de validação segue estas etapas:
Sua aplicação → API Bluube → Verificação da chave → Resposta (válida / inválida)
- Sua aplicação envia a chave: ao iniciar ou em intervalos regulares, sua app faz uma requisição
POST para a API da Bluube com a chave de licença do usuário.
- A Bluube verifica a chave: o servidor checa todas as condições necessárias para considerar a licença válida.
- A Bluube retorna a resposta: sua aplicação recebe um objeto JSON indicando se a licença é válida e os detalhes relevantes.
O que a validação verifica
A cada chamada, a Bluube confere os seguintes critérios:
| Verificação | Descrição |
|---|
| Chave existe | A chave informada está cadastrada no sistema. |
| Não expirada | A data de expiração ainda não foi atingida (para licenças time_limited e trial). |
| Não suspensa | A licença não foi suspensa ou revogada manualmente. |
| Dentro do limite | O número de ativações não excede o valor definido em max_activations. |
Campos da resposta
| Campo | Tipo | Descrição |
|---|
valid | boolean | true se a licença passou em todas as verificações; false caso contrário. |
status | string | Estado atual da licença: active, expired, suspended ou not_found. |
expiration_date | string (ISO 8601) | Data de expiração da licença, quando aplicável. |
message | string | Mensagem descritiva sobre o resultado da validação. |
Exemplo de chamada de validação
curl -X POST https://api.bluube.com/v1/validate \
-H "Authorization: Bearer <sua_api_key>" \
-H "Content-Type: application/json" \
-d '{"key": "BLUUBE-XXXX-YYYY-ZZZZ"}'
Exemplo de resposta
{
"valid": true,
"status": "active",
"expiration_date": "2026-12-31T23:59:59Z",
"message": "Licença válida e ativa."
}
{
"valid": false,
"status": "expired",
"expiration_date": "2025-03-01T00:00:00Z",
"message": "Esta licença expirou em 01/03/2025."
}
A validação online requer conexão com a internet. Se sua aplicação precisa funcionar em ambientes offline, considere implementar uma validação local baseada em cache: armazene o resultado da última validação bem-sucedida e defina uma janela de tolerância (por exemplo, 24 horas) antes de exigir uma nova verificação online.