开发者常见问题
将您的产品与 LicenseOS 集成所需的一切信息。
1 快速开始
▶
如何成为 LicenseOS 开发者?
- 点击<strong>注册</strong>创建账户。
- 从用户菜单或页脚链接进入<strong>开发者 → 申请</strong>页面。
- 填写开发者资料(名称、网站、简介)并提交。
- 管理员审批通过后,您将获得<strong>开发者控制台</strong>的访问权限。
- 在控制台中进入<strong>产品 → 创建</strong>发布您的第一个产品。
▶
如何获取 API Key?
开发者账户审批通过后:
- 进入<strong>开发者控制台 → API 密钥</strong>。
- 点击<strong>生成新密钥</strong>。
- 复制密钥——它只会显示一次。
- 在 SDK 初始化时使用此密钥作为
api_key参数。
▶
支持哪些产品类型?
wp_plugin — WordPress Plugin
wp_theme — WordPress Theme
android_app — Android App
ios_app — iOS App
desktop_app — Desktop App
web_app — Web App
chrome_extension — Chrome Extension
shopify_app — Shopify App
figma_plugin — Figma Plugin
laravel_package — Laravel Package
source_code — Source Code
script — Script
api_service — API Service
template — Template
ebook — eBook
course — Online Course
other — Other
2 SDK 集成(WordPress)
▶
快速上手:在 WordPress 插件中集成 LicenseOS SDK
从平台下载 SDK 文件并包含在您的插件中,在插件主文件中初始化:
// 在插件主文件中(如 my-plugin.php)
require_once __DIR__ . '/licenseos-sdk.php';
// 使用平台 API URL 和 API Key 初始化
LicenseOS::init(
'https://your-licenseos-domain.com/api/v2',
'your-api-key-here'
);
// 启用 WordPress 自动更新集成
LicenseOS::enableAutoUpdate(
'your-plugin-slug',
'stored-license-key'
);
这样就可以在 WordPress 中直接实现许可证激活、状态检查和自动更新。
▶
如何在插件中添加许可证激活页面?
创建一个设置页面让用户输入许可证密钥,然后调用 SDK:
// 用户提交许可证密钥时
function my_plugin_activate_license($key) {
$domain = parse_url(home_url(), PHP_URL_HOST);
$result = LicenseOS::activate($key, $domain, 'my-plugin-slug');
if ($result['status'] === 'success') {
update_option('my_plugin_license_key', $key);
update_option('my_plugin_license_status', 'active');
return 'License activated!';
}
return 'Activation failed: ' . ($result['message'] ?? 'Unknown error');
}
▶
如何在每次页面加载时检查许可证状态?
使用缓存检查避免每次请求都调用 API,每小时验证一次:
function my_plugin_check_license() {
$key = get_option('my_plugin_license_key');
if (!$key) return false;
// 缓存检查结果 1 小时
$cached = get_transient('my_plugin_license_check');
if ($cached !== false) return $cached === 'valid';
$result = LicenseOS::check($key);
$valid = ($result['status'] ?? '') === 'valid';
set_transient('my_plugin_license_check',
$valid ? 'valid' : 'invalid', HOUR_IN_SECONDS);
return $valid;
}
3 License API
▶
API 接口参考
| 方法 | Endpoint | 认证 | 说明 |
|---|---|---|---|
POST | /api/v2/license/activate | API Key | 在指定域名上激活许可证 |
POST | /api/v2/license/check | API Key | 检查许可证状态和到期时间 |
GET | /api/v2/update/check | API Key | 检查新版本 |
GET | /api/v2/download | License Key | 安全下载 |
通过 X-API-KEY 请求头传递 API Key,所有响应均为 JSON 格式。
4 更新系统
▶
如何发布新版本?
- 进入开发者 → 产品,点击您的产品。
- 在上传新版本区域填写版本号、ZIP 文件和更新日志。
- 点击上传版本。
- 所有拥有有效许可证的客户将自动看到更新。
5 定价与佣金
▶
价格档位是如何工作的?
每个产品支持多种价格档位:试用、月付、季付、半年付、年付和永久。在产品的<strong>编辑 → 价格档位</strong>区域进行配置。
▶
佣金是如何计算的?
每次销售时,平台会扣除佣金费用,剩余金额为您的<strong>开发者收入</strong>。可在<strong>开发者 → 收益提现</strong>中查看明细。
6 提现
▶
如何提现?
- 在开发者 → 收益提现 → 提现方式中设置提现账户。
- 支持的方式:银行转账、PayPal、支付宝、微信支付。
- 点击申请提现并输入金额。
- 管理员审核并处理提现。
7 常见问题排查
▶
许可证激活返回“max domains reached”
许可证已在最大允许数量的域名上激活。请购买更高档位的许可证以获得更多域名配额。
▶
WordPress 不显示可用更新
- 确认
enableAutoUpdate()在LicenseOS::init()之后调用。 - 确保插件 slug 与平台注册的产品 slug 一致。
- 强制刷新:仪表盘 → 更新 → 重新检查。
▶
API 返回“Invalid API key”或 401
- 确认
X-API-KEY请求头已正确发送。 - 确认 API Key 未被撤销。
- 如有需要,重新生成新密钥。