API de licencias de software: activación, validación y latidos
Elige lenguaje y operación y llama al SDK. Gestiona activación, identidad del dispositivo, firmas, caché, latidos y reserva, confirmación y cancelación de uso.
Common scenario snippets
En los ejemplos, client procede del inicio, path es la ruta de exportación y exportReport / export_report es tu función. jobID es el ID estable guardado por la aplicación.
Ver el código completo → · Inicio rápido · Consulta la integración medida y los reintentos →
El SDK ejecuta solo con permiso. RunFeature no descuenta uso; RunMeteredFeature reserva, confirma tras el éxito y cancela tras el fallo. Reintenta la tarea original para confirmar sin repetir el trabajo completado.
Complete SDK method reference
The scenarios above are short call snippets. Below are the current language’s public methods, properties and utilities, including full signatures, parameters, results, errors, configuration and data fields. The reference follows the selected language and identifies capabilities that are unavailable in a wrapper.
Mostrar solicitudes y respuestas HTTP (clientes propios o diagnóstico)
Los SDK ya implementan el protocolo siguiente. Las aplicaciones que usan estos nueve SDK no necesitan implementarlo de nuevo.
Las ocho interfaces autentican licencia y dispositivo, sin cookies, CSRF ni claves de administración. Las sesiones flotantes se liberan al salir; los dispositivos vinculados siguen registrados.
¿Cómo compruebo acceso tras activar, validar o enviar un heartbeat?
- Comprueba HTTP 200 y lee
data.activation_id. Incluye este ID en validaciones, heartbeats, mediciones y desactivaciones posteriores. - Verifica con la clave pública del producto de confianza
data.leasey comprueba producto, dispositivo, vigencia y funciones. Decodificar payload como JSON no demuestra que la licencia sea válida. - El SDK automatiza los dos primeros pasos. RunFeature comprueba acceso antes de la operación; RunMeteredFeature gestiona reserva, confirmación y cancelación para contadores.
El SDK guarda caché firmada y envía heartbeats según la política. No borres caché válida solo por un timeout. Ante revocación, liberación o caducidad explícita, bloquea funciones protegidas según el SDK.
¿Qué significan campos del payload decodificado?
El ejemplo solo explica los datos. Si verificas la firma por tu cuenta, usa los bytes originales de payload; no reordenes ni serialices el JSON antes.
Reintentos, heartbeats y facturación
Obligatorio para activar, desactivar y medir Idempotency-Key, hasta 80 caracteres sin espacios. Nueva operación, nuevo valor; al reintentar, conserva valor y cuerpo. Opcional para validación y heartbeat; el SDK gestiona sus propios IDs.
Mientras la autorización siga siendo válida, las solicitudes idénticas de validación y heartbeat pueden reintentarse durante una hora sin cargos duplicados. Después, usa una nueva clave de solicitud; una clave antigua puede tratarse como una nueva solicitud. La activación, la desactivación y el consumo de funciones conservan registros duraderos de idempotencia.
Cada activación, validación, heartbeat o desvinculación correcta consume una llamada API. Fallos y repeticiones idempotentes no se recuentan; CheckFeature es local. Consume descuenta usos de función, no esta cuota API; quantity indica cuántos.
Intervalo, duración offline y permanente siguen Políticas de licencia.payload.expires_at es la caducidad de la caché firmada actual, no la fecha final de la licencia. Consulta esa fecha en los detalles de licencia.