Domande comuni

Inizia con il codice di errore restituito, quindi controlla le sue impostazioni. La risposta è request_id aiuta a trovare questa operazione nei log del server. Non inserire chiavi complete nei log o negli screenshot.

Cosa devo controllare se l'attivazione non riesce?

Verifica che il server URL sia raggiungibile, l'ID prodotto sia corretto, il codice di licenza sia completo e appartenga a questo prodotto. Fino alla distribuzione, i computer dei clienti non possono utilizzare il tuo 127.0.0.1 indirizzo; si riferisce al computer del cliente.

Codice errore	Primo passo
`LICENSE_INVALID`	Controllare l'ID prodotto, la chiave di licenza completa e il prodotto con licenza
`LICENSE_EXPIRED`	Controlla la scadenza della licenza; il venditore lo rinnova quando necessario
`LICENSE_REVOKED` `DEVICE_RELEASED`	Licenza revocata o dispositivo rilasciato; SDK cancella la vecchia cache
`DEVICE_LIMIT_REACHED`	Slot del dispositivo con licenza pieni; rilasciare un vecchio dispositivo o aumentarne il limite
`API_QUOTA_EXCEEDED`	API quota hard esaurita; controlla il periodo e i limiti del piano
`API_BALANCE_INSUFFICIENT`	Saldo eccedente API insufficiente; controllare la valuta e l'ambiente
`MONTHLY_QUOTA_EXCEEDED`	Raggiunto il limite massimo del dispositivo della piattaforma; separato dal limite del dispositivo della licenza
`IDEMPOTENCY_CONFLICT`	Stessa chiave utilizzata per corpi diversi; la nuova operazione richiede una nuova chiave, i tentativi mantengono il corpo originale
`IDEMPOTENCY_EXPIRED`	Vecchia risposta o associazione del dispositivo non valida; controlla lo stato e usa una nuova chiave per una nuova operazione

Perché funziona ancora offline?

L'utilizzo offline controlla comunque la firma del server, il prodotto, il dispositivo, le funzionalità e la scadenza localmente. Viene omessa solo la richiesta del server. Le cache scadute o le risposte esplicite di revoca/rilascio online bloccano l'ulteriore utilizzo.

Perché la verifica della firma o del dispositivo non riesce?

Una chiave pubblica non corrispondente, la cache di un altro prodotto o una cache copiata su un computer diverso possono causare errori. Controlla trusted_keys utilizza l'ID chiave e la chiave pubblica del prodotto corrente, quindi controlla se il sistema operativo è stato sostituito o reinstallato.

SDK rapporti clock rollback : controlla se l'orologio si è spostato indietro. Correggilo, quindi aggiorna esplicitamente online.

Risposta all'errore completa

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

Campo	Significato e azione
`error.code` · string	Identificatore di errore stabile per la logica del programma; non fare affidamento sulla formulazione del messaggio.
`error.message` · string	Motivo dell'errore leggibile dall'utente per la diagnosi o un messaggio rivolto al cliente.
`request_id` · UUID	ID richiesta HTTP generato dal server per i log; non l'ID di licenza o la chiave di idempotenza.

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.

Come leggo la risposta JSON?

Risposta riuscita data e request_id; ritornano i fallimenti error.code, error.message e request_id. Conserva il codice di errore e request_id per individuare la maggior parte dei problemi.

Per le impostazioni di posta elettronica, pagamento o distribuzione, vedere Supporto e risoluzione dei problemi.