Preguntas frecuentes

Revisa el código de error y su configuración. En la respuesta, request_id ayuda a localizar en registros. No incluyas claves completas en registros/capturas.

¿Qué reviso si falla la activación?

Comprueba acceso al servidor, ID del producto, código completo y que la licencia sea de ese producto. Antes de desplegar, el equipo cliente no puede usar tu 127.0.0.1 ; esa dirección corresponde al propio equipo del cliente.

Código de error	Primer paso
`LICENSE_INVALID`	Comprueba ID, clave completa y producto de licencia
`LICENSE_EXPIRED`	Consultar caducidad; proveedor renueva si hace falta
`LICENSE_REVOKED` `DEVICE_RELEASED`	Licencia revocada o equipo liberado; SDK borra caché
`DEVICE_LIMIT_REACHED`	Plazas llenas; libera un equipo o aumenta límite
`API_QUOTA_EXCEEDED`	Cuota API agotada; revisa período y plan
`API_BALANCE_INSUFFICIENT`	Saldo de exceso API insuficiente; comprueba moneda y entorno
`MONTHLY_QUOTA_EXCEEDED`	Tope de plataforma alcanzado, distinto del límite de licencia
`IDEMPOTENCY_CONFLICT`	Misma Key con cuerpos distintos; nueva operación nueva Key, retry mismo cuerpo
`IDEMPOTENCY_EXPIRED`	Respuesta/vínculo inválido; comprueba estado y nueva Key para nueva operación

¿Por qué sigue funcionando sin conexión?

Offline, el SDK verifica localmente firma, producto, dispositivo, funciones y caducidad; solo omite la petición al servidor. Caché caducada o rechazo explícito de revocación/liberación impide seguir usando.

¿Por qué falla la firma o la comprobación del equipo?

Una clave pública distinta, caché de otro producto o copiada a otro equipo pueden causar fallos. Comprueba trusted_keys usa el ID y la clave pública del producto actual; comprueba después si se cambió o reinstaló el sistema.

SDK informa clock rollback : comprueba retroceso del reloj. Corrige y actualiza online.

Respuesta de error completa

{
  "error": {
    "code": "LICENSE_REVOKED",
    "message": "License was revoked"
  },
  "request_id": "99999999-9999-4999-8999-999999999999"
}

Campo	Significado y acción
`error.code` · string	Identificador estable para lógica, no el texto de message.
`error.message` · string	Motivo legible para diagnóstico o mensaje al cliente.
`request_id` · UUID	ID HTTP del servidor para registros; no licencia ni Idempotency-Key.

For 400 / 415 correct fields or Content-Type; for 401 check the management key; for 403 inspect the licensing error; for 409 check limits, session state or idempotency conflicts; for 429 wait according to Retry-After. Runtime retries retain their Idempotency-Key and body. Recover management writes using each operation’s idempotency rules; never blindly repeat ordinary issuance or renewal after a timeout.

¿Cómo leo la respuesta JSON?

Respuesta correcta data y request_id; los fallos devuelven error.code, error.message y request_id. Conserva código de error y request_id para diagnosticar.

Para correo, pagos o despliegue, consulta Soporte y diagnóstico.