跳到正文

產品與授權 API

把下單后的簽發工作接到你自己的伺服器:先建立產品和策略,再為每位客戶建立授權。前兩項通常只需設定一次。

先在控制臺建立有寫權限的 管理 API Key。以下示例使用 Authorization: Bearer YOUR_MANAGEMENT_API_KEY;這個 Key 保留在廠商伺服器中。

The examples above show the minimum issuance flow. For queries, updates, archiving, renewals, devices, usage, offline licensing and events, see “All management requests and responses” under 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。