よくある質問

返されたエラーコードから始めて、その設定を確認してください。応答の request_id サーバーログでこの操作を見つけるのに役立ちます。ログやスクリーンショットに完全なキーを含めないでください。

アクティベーションが失敗した場合は何を確認すればよいですか?

サーバー URL にアクセスできること、製品 ID が正しいこと、完全なライセンスキーがその製品に属することを確認します。公開サーバーへの移行が済むまでは、顧客の端末から次のローカルアドレスには接続できません： 127.0.0.1 。顧客の端末上では、その端末自身を指すアドレスだからです。

エラーコード	最初のステップ
`LICENSE_INVALID`	プロダクト ID、完全なライセンスキー、ライセンス製品を確認します。
`LICENSE_EXPIRED`	ライセンスの有効期限を確認します。ベンダーは必要に応じて更新します
`LICENSE_REVOKED` `DEVICE_RELEASED`	ライセンスが取り消されるか、デバイスが解放される。 SDK は古いキャッシュをクリアします
`DEVICE_LIMIT_REACHED`	ライセンスデバイスのスロットがいっぱいです。古いデバイスを解放するか、制限を増やす
`API_QUOTA_EXCEEDED`	API ハードクォータを使い果たしました。期間とプランの制限を確認する
`API_BALANCE_INSUFFICIENT`	API 超過残高が不十分です。通貨と環境を確認する
`MONTHLY_QUOTA_EXCEEDED`	プラットフォームデバイスの上限に達しました。ライセンスのデバイス制限とは別に
`IDEMPOTENCY_CONFLICT`	異なるボディに同じキーが使用されます。新しい操作には新しいキーが必要です。再試行では元の本文が保持されます
`IDEMPOTENCY_EXPIRED`	古い応答またはデバイスバインディングが無効です。状態を確認し、新しい操作に新しいキーを使用します

なぜオフラインでも機能するのでしょうか?

オフライン使用でも、サーバーの署名、製品、デバイス、機能、有効期限がローカルでチェックされます。サーバーリクエストのみ省略されています。期限切れのキャッシュまたは明示的なオンライン失効/解放応答により、それ以上の使用がブロックされます。

署名またはデバイスの検証が失敗するのはなぜですか?

公開鍵の不一致、別の製品のキャッシュ、または別のコンピュータにコピーされたキャッシュにより、障害が発生する可能性があります。チェックする trusted_keys 現在の製品のキー ID と公開鍵を使用している場合は、オペレーティングシステムが交換または再インストールされたかどうかを確認します。

SDK レポート clock rollback : 時計が逆方向に進んだかどうかを確認します。修正してから、オンラインで明示的に更新してください。

完全なエラー応答

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

フィールド	意味と行動
`error.code` · string	message のテキストとは関係なく、プログラムが処理方法を決定する安定したエラーフラグ。
`error.message` · string	人間が判読できる障害の診断理由または顧客向けメッセージ。
`request_id` · UUID	ログチェックのために、この HTTP リクエストに対してサーバーによって生成された番号。ライセンス ID や Idempotency-Key ではありません。

400 / 415 ではフィールドと Content-Type、401 では管理キー、403 ではライセンスのエラー理由、409 では上限・セッション状態・冪等性の競合を確認します。429 では Retry-After に従って待機してください。実行時 API の再試行では、元の冪等性キーと本文を保持します。管理 API の書き込み結果が不明な場合は、その操作の冪等性ルールに従って確認してください。タイムアウト後に発行や延長を無条件で繰り返してはいけません。

JSON 応答を読み取るにはどうすればよいですか?

成功した応答 data と request_id;失敗が戻る error.code、error.message と request_id。ほとんどの問題を特定するには、エラーコードと request_id を保存しておいてください。

電子メール、支払い、展開の設定については、次を参照してください。サポートとトラブルシューティング。