开发者常见问题

将您的产品与 LicenseOS 集成所需的一切信息。

1 快速开始

如何成为 LicenseOS 开发者?
  1. 点击<strong>注册</strong>创建账户。
  2. 从用户菜单或页脚链接进入<strong>开发者 → 申请</strong>页面。
  3. 填写开发者资料(名称、网站、简介)并提交。
  4. 管理员审批通过后,您将获得<strong>开发者控制台</strong>的访问权限。
  5. 在控制台中进入<strong>产品 → 创建</strong>发布您的第一个产品。
如何获取 API Key?

开发者账户审批通过后:

  1. 进入<strong>开发者控制台 → API 密钥</strong>。
  2. 点击<strong>生成新密钥</strong>。
  3. 复制密钥——它只会显示一次。
  4. 在 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/activateAPI Key在指定域名上激活许可证
POST/api/v2/license/checkAPI Key检查许可证状态和到期时间
GET/api/v2/update/checkAPI Key检查新版本
GET/api/v2/downloadLicense Key安全下载

通过 X-API-KEY 请求头传递 API Key,所有响应均为 JSON 格式。

4 更新系统

如何发布新版本?
  1. 进入开发者 → 产品,点击您的产品。
  2. 上传新版本区域填写版本号、ZIP 文件和更新日志。
  3. 点击上传版本
  4. 所有拥有有效许可证的客户将自动看到更新。

5 定价与佣金

价格档位是如何工作的?

每个产品支持多种价格档位:试用、月付、季付、半年付、年付和永久。在产品的<strong>编辑 → 价格档位</strong>区域进行配置。

佣金是如何计算的?

每次销售时,平台会扣除佣金费用,剩余金额为您的<strong>开发者收入</strong>。可在<strong>开发者 → 收益提现</strong>中查看明细。

6 提现

如何提现?
  1. 开发者 → 收益提现 → 提现方式中设置提现账户。
  2. 支持的方式:银行转账、PayPal、支付宝、微信支付。
  3. 点击申请提现并输入金额。
  4. 管理员审核并处理提现。

7 常见问题排查

许可证激活返回“max domains reached”

许可证已在最大允许数量的域名上激活。请购买更高档位的许可证以获得更多域名配额。

WordPress 不显示可用更新
  1. 确认 enableAutoUpdate()LicenseOS::init() 之后调用。
  2. 确保插件 slug 与平台注册的产品 slug 一致。
  3. 强制刷新:仪表盘 → 更新 → 重新检查
API 返回“Invalid API key”或 401
  • 确认 X-API-KEY 请求头已正确发送。
  • 确认 API Key 未被撤销。
  • 如有需要,重新生成新密钥。