API de produtos e licenças
Emita licenças no seu servidor após o pedido: crie o produto e a política, depois uma licença por cliente. Produto e política normalmente são configurados uma vez.
Crie primeiro no painel um Chave API de gerenciamento. Os exemplos abaixo usam Authorization: Bearer YOUR_MANAGEMENT_API_KEY; mantenha esta chave no servidor do fornecedor.
The examples above show the minimum issuance flow. For queries, updates, archiving, renewals, devices, usage, offline licensing and events, see “All management requests and responses” under Management API Key.
Informe a validade ao emitir: 1–36500 dias para prazo fixo e teste; nenhum para licenças perpétuas. A política não armazena essa duração.
Use data.id da resposta do produto como product_id e data.id da resposta da política como policy_id. Após emitir uma licença, guarde data.id e data.key.
Pode voltar a ver e copiar a chave completa na lista de licenças. Partilhe-a apenas com o cliente correspondente.
Para licença por prazo antes da ativação,expires_at e first_activated_at são null. Prazo começa na primeira ativação; troca não renova a duração.
Gestão posterior
| Método e caminho (sem /api/v1) | Uso e corpo da requisição |
|---|---|
GET /products | Lista os produtos. Na resposta, data.items é a lista de registros e data.total é a quantidade total. |
GET /licenses/{id} | Consultar licença, primeira ativação e expiração. |
POST /licenses/{id}/renew | Renovar, como {"days":30}. Mantém a licença original. |
POST /licenses/{id}/revoke | Revogar; corpo {}. |
GET /products/{id}/public-keys | Leia chaves públicas sem autenticação. Fixe chaves confiáveis ao distribuir SDK. |
GET /activations | Ver vínculos de dispositivos e sessões. |
Paginação usa limit=25&offset=0, limit no máximo 100. Outros parâmetros e estruturas em Arquivo OpenAPI; veja o tópico à esquerda correspondente ao modelo.
Como chamar com sessão do navegador?
Requisições de escrita com cookies exigem X-CSRF-Token. Faça GET /api/v1/auth/csrf e use data.csrf_token nesse cabeçalho. Bearer Key dispensa CSRF.