Perguntas frequentes

Veja primeiro o código de erro e depois a configuração. Na resposta, request_id ajuda a localizar nos logs. Não inclua chave completa em logs/capturas.

O que verificar se a ativação falhar?

Confira acesso ao servidor, ID do produto, código completo e vínculo da licença ao produto. Antes de implantar, computadores de clientes não podem usar seu 127.0.0.1 ; esse endereço aponta para o computador do cliente.

Código de erro	Primeiro passo
`LICENSE_INVALID`	Confira ID, chave completa e produto da licença
`LICENSE_EXPIRED`	Ver validade; fornecedor renova se necessário
`LICENSE_REVOKED` `DEVICE_RELEASED`	Licença revogada ou dispositivo liberado; cache limpo
`DEVICE_LIMIT_REACHED`	Vagas cheias; libere dispositivo ou aumente limite
`API_QUOTA_EXCEEDED`	Cota API esgotada; veja período/plano
`API_BALANCE_INSUFFICIENT`	Saldo excedente API insuficiente; confira moeda/ambiente
`MONTHLY_QUOTA_EXCEEDED`	Limite da plataforma atingido, separado do limite da licença
`IDEMPOTENCY_CONFLICT`	Mesmo Key para textos diferentes; nova operação novo Key, retry mesmo corpo
`IDEMPOTENCY_EXPIRED`	Resposta/vínculo inválido; confira estado e use Key novo para nova operação

Por que ainda funciona offline?

Offline, o SDK ainda verifica assinatura, produto, dispositivo, funções e vencimento localmente. Apenas não consulta o servidor. Cache expirado ou recusa explícita de revogação/liberação impede o uso.

Por que falha a verificação da assinatura ou dispositivo?

Chave pública incompatível, cache de outro produto ou copiado para outro computador podem causar falha. Confira trusted_keys usa o ID e a chave pública do produto atual; depois confira se o sistema foi trocado ou reinstalado.

SDK informa clock rollback : veja se relógio voltou. Corrija e atualize online.

Resposta de erro completa

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

Campo	Significado e ação
`error.code` · string	Identificador estável na lógica; não dependa de message.
`error.message` · string	Motivo legível para diagnóstico ou mensagem ao cliente.
`request_id` · UUID	ID de requisição para logs; não licença ou 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.

Como ler a resposta JSON?

Resposta de sucesso data e request_id; falhas retornam error.code, error.message e request_id. Guarde código de erro e request_id para diagnóstico.

Para e-mail, pagamento ou implantação, veja Suporte e diagnóstico.