個核心 Endpoint
驗證回應時間
行程式碼生成序號
為軟體授權設計的 API
啟用、驗證、停用、查裝置 — 每個都只做一件事,乾淨好整合
啟用序號
POST /v1/license-keys/activate客戶首次啟動軟體時呼叫,綁定裝置指紋並記錄啟用。支援設定啟用上限,超過自動拒絕。
驗證序號
POST /v1/license-keys/validate軟體啟動時呼叫,檢查序號狀態、到期日、啟用數量。一個 API 呼叫取得完整授權狀態。
停用序號
POST /v1/license-keys/deactivate客戶更換裝置時呼叫,釋放一個啟用名額。不需要你介入,客戶自己管理裝置。
列出啟用裝置
GET /v1/license-keys/:id/instances查詢特定序號已啟用的所有裝置列表,包含裝置名稱、指紋、啟用時間。
5 行程式碼驗證授權
在你的軟體中
驗證序號
一個 POST 請求就能確認客戶的序號是否有效。 回傳序號狀態、剩餘啟用數、到期日等完整資訊。
- 只需要 Publishable Key,前後端皆可
- 回傳序號完整狀態與元資料
- 支援裝置指紋 (instance_id) 驗證
const res = await fetch(
'https://api.recur.tw/v1/license-keys/validate',
{
method: 'POST',
headers: { 'Authorization': `Bearer ${key}` },
body: JSON.stringify({ license_key, instance_id }),
},
)
// => { valid: true, license_key: { status: 'active', ... } }
完整的序號授權功能
從生成到管理,每個環節都有對應功能
購買即自動生成
客戶付款完成,序號自動生成並透過 Email 發送。零人工介入、零延遲。
- 結帳完成自動觸發
- 可自訂序號前綴(如 MYAPP-)
- 序號格式:XXXX-XXXX-XXXX-XXXX
裝置啟用管理
設定每組序號可啟用的裝置數量,客戶可以自己管理裝置列表。
- 可設定 1~N 台裝置上限
- 裝置指紋自動記錄
- 客戶自助停用舊裝置
訂閱制連動
序號可以綁定訂閱方案,訂閱到期自動停用序號,續費自動恢復。
- 月繳/年繳自動續約
- 到期自動失效、續費自動啟用
- 升降級同步更新序號權限
管理 API
用 Secret Key 管理所有序號:查詢、列表、停用、更新。完整的 CRUD 操作。
- 依客戶、產品、狀態篩選
- 手動停用/啟用序號
- 查看每組序號的啟用裝置
在產品設定中開啟「序號授權」,系統就會在每次購買後自動生成序號
零程式碼序號生成
客戶付款
序號自動到手
不需要寫序號生成邏輯、不需要建資料庫、不需要寫寄信程式。 在產品設定中打開開關,剩下的交給 Recur。
- 可自訂序號前綴,品牌一致性
- 可設定啟用上限與到期天數
- 同時支援一次性購買與訂閱制
裝置管理
客戶自己管理裝置
你不需要介入
每組序號可以設定啟用裝置上限。客戶換電腦時, 可以自己停用舊裝置、在新裝置重新啟用。不需要找你客服。
- activate / deactivate 就是客戶的裝置管理
- Management API 可查看所有啟用裝置 (instances)
- 超過上限自動拒絕,不需要你寫邏輯
MacBook Pro
ins_a1b2c3
Windows Desktop
ins_d4e5f6
(可再啟用 1 台裝置)
序號生命週期事件
每一個序號狀態變更都會觸發 Webhook,讓你的系統即時回應
license_key.created序號建立(購買完成時)license_key.activated序號啟用(裝置綁定時)license_key.deactivated序號停用(裝置解除時)license_key.disabled序號失效(手動或訂閱到期)license_key.expired序號過期(到期日到達時)收款 + 授權,一站搞定
不再需要分別串接金流和授權系統
LemonSqueezy
手續費:5% + US$0.50
- 基本序號功能
- Stripe 收購後定位不明
- 不支援台幣
- 美元結算
Keygen
手續費:US$49+/月
- 最完整的授權功能
- 固定月費、門檻高
- 不支援收款(純授權)
- 需自行串接金流
Recur
推薦手續費:2.4%,平台費 $0
- 收款 + 序號一站搞定
- 台幣定價、台灣金流
- 購買自動生成序號
- MCP / AI Agent 整合
- 電子發票(即將推出)
AI Agent 就緒
用對話管理序號
Recur 的 MCP 伺服器讓 AI 助手可以直接管理序號、 查詢啟用狀態、處理客服問題。開發者的最佳工作流。
- 「查一下這組序號的啟用裝置列表」
- 「幫我停用這個客戶的序號」
- 「產生驗證序號的 TypeScript 程式碼」