API de productos y licencias
Emite licencias desde tu servidor tras un pedido: crea el producto y la política, luego una licencia por cliente. Los dos primeros suelen configurarse una sola vez.
Crea primero en consola uno con escritura Clave API de gestión. Los ejemplos siguientes usan Authorization: Bearer YOUR_MANAGEMENT_API_KEY; conserva esta clave en el servidor del proveedor.
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.
Indica los días al emitir: 1–36500 para licencias temporales y de prueba; ninguno para perpetuas. La política no guarda esa duración.
Use data.id de la respuesta del producto como product_id y data.id de la respuesta de la política como policy_id. Tras emitir una licencia, guarde data.id y data.key.
Puede volver a ver y copiar la clave completa en la lista de licencias. Compártala solo con el cliente correspondiente.
Para licencia limitada antes de activar,expires_at y first_activated_at son null. La vigencia empieza al activar; cambiar de equipo no la reinicia.
Gestión posterior
| Método y ruta (sin /api/v1) | Uso y cuerpo de petición |
|---|---|
GET /products | Lista productos. En la respuesta, data.items es el arreglo de registros y data.total su número total. |
GET /licenses/{id} | Consultar licencia, primera activación y caducidad. |
POST /licenses/{id}/renew | Renovar, como {"days":30}. Mantiene la licencia original. |
POST /licenses/{id}/revoke | Revocar; cuerpo {}. |
GET /products/{id}/public-keys | Leer claves públicas sin autenticación. Fija claves de confianza al distribuir el SDK. |
GET /activations | Ver vínculos de dispositivos y sesiones. |
La paginación usa limit=25&offset=0, limit máximo 100. Otros parámetros y esquemas en Archivo OpenAPI; consulta el tema de la izquierda para cada modelo.
¿Cómo llamar con sesión del navegador?
Las escrituras con cookies requieren X-CSRF-Token. Primero GET /api/v1/auth/csrf y luego pon data.csrf_token en esa cabecera. Bearer Key no requiere CSRF.