製品とライセンス API
注文後に独自のサーバーからライセンスを発行します。製品とポリシーを作成してから、顧客ごとにライセンスを作成します。通常、製品とポリシーは一度構成されます。
まず書き込み可能なものを作成します 管理 API キー。以下の例では、 Authorization: Bearer YOUR_MANAGEMENT_API_KEY;このキーをベンダーのサーバー上に保管してください。
上記の例は、最小限の発行フローを示しています。クエリ、更新、アーカイブ、更新、デバイス、使用状況、オフライン ライセンスおよびイベントについては、次を参照してください。 Management API Key の下の「すべての管理要求と応答」。
ライセンスを発行するときに有効日数を入力します。期限付きライセンスと試用ライセンスの場合は 1 ~ 36500、永久ライセンスの場合はなしです。ポリシーでは有効期限は保存されません。
製品の応答の data.id を product_id、ポリシーの応答の data.id を policy_id として使用します。ライセンス発行後は data.id と data.key を保存してください。
ライセンス一覧から完全なキーを再度表示・コピーできます。該当するお客様にのみ共有してください。
アクティベーション前の期限付きライセンスの場合、expires_at と first_activated_at は null です。有効期間は最初の認証成功時から始まります。端末を移行しても、有効期間はリセットされません。
さらなる管理
| メソッドとパス (/api/v1 なし) | 目的とリクエスト本文 |
|---|---|
GET /products | 製品をリストします。応答では、data.items はレコード配列、data.total は合計数です。 |
GET /licenses/{id} | ライセンスの詳細、最初のアクティベーションと有効期限を確認します。 |
POST /licenses/{id}/renew | 有効期間を延長します。例:{"days":30}。元のライセンスは保持されます。 |
POST /licenses/{id}/revoke | 取り消します。リクエスト本文は {} です。 |
GET /products/{id}/public-keys | 認証なしで製品の公開鍵を読み取ります。 SDK を配布するときに、信頼できるキーを固定します。 |
GET /activations | デバイス バインディングとランタイム セッションを表示します。 |
ページネーションの使用をリストする limit=25&offset=0, limit 最大値は 100 です。他のインターフェイスのパラメーターと構造については、を参照してください。 OpenAPIファイル;各ライセンス モデルについては、左側の関連トピックを参照してください。
ブラウザーのログインセッションから呼び出す方法は?
ブラウザーの Cookie を使用した書き込みには、X-CSRF-Token が必要です。まず GET /api/v1/auth/csrf、次にそのヘッダーに data.csrf_token を入れます。 Bearer Key リクエストには CSRF は必要ありません。