认证中心
← 全部文档与搜索
独立页面 ↗下载 Markdown
本文目录 · 6 节

开发者会员与应用管理

个人工作台的「会员与权益」展示当前套餐、到期时间、后续套餐、应用名额、登录余额、存储占用和自带 S3 权益。软件用户授权仍在「软件授权」,开发者平台套餐在「开发者 → 套餐与扩容」。

体验与套餐

体验是否开放、名称、有效天数、应用数、登录次数、存储额度和自带 S3 权限均由管理员配置。管理员关闭体验后不再接受领取,已领取的权益保留领取时快照。每个账户只能领取一次;已购买基础套餐的账户不能补领。体验应用支持其他用户正常登录,所有用户共享套餐登录额度;仍受有效期、应用名额和单应用登录上限约束,刷新令牌不重复扣次数。

正式套餐价格、期限、额度、单次登录价格和到期宽限也由管理员配置,价格可以为 0,但不能为负数。购买前以页面展示为准。免费套餐仍按正式套餐管理,需要由管理员明确上架;用户确认后订单立即完成并发放权益,不进入支付渠道,也不扣积分。同类免费资源包在已有权益有效期内不能重复叠加,到期后可再次领取;免费订阅可持续续费。管理员直接编辑同一个套餐,历史配置自动保存在变更记录中,套餐名称无需因调价而更换。旧的独立套餐可选择归属套餐并入历史记录。已创建订单与已领取权益保留原快照,价格或权益在下单前发生变化时需要刷新后重新确认。按天与按月期限二选一;基础订阅的登录池按购买账期的月度锚点更新,次数包不按月重置。普通购买接续已有付费或免费套餐;相同按月周期、价格更高且各项资源不减少时可立即升级,先查看差价报价再下单。

套餐与次数包耗尽后,仅在主动开启按量消费、套餐支持按量、预付余额充足且账户/应用预算未超限时扣费。自然月预算按 UTC 统计。预算和预付金额使用人民币,内部细分计价支持小于一分钱的单次费用。余额自动续费默认关闭,只消费预付余额;付费套餐达到单次金额上限、归属套餐下架或余额不足时不会自动向支付渠道扣款。价格为 0 的订阅套餐也可开启自动续费,续期会写入余额流水但扣款金额为 0,不要求预付余额。已确认的自动续费保留原有价格与权益,套餐编辑或归并不会改写它;更换续费套餐,或勾选「改用当前套餐价格与权益续费」并保存,才采用新配置。仅修改消费预算不会改变已确认的续费条款。

创建应用

开发者侧栏进入「我的应用」,创建后及时保存仅展示一次的凭据。应用可启停、归档恢复、配置单应用登录上限与预算。归档撤销凭据并释放应用名额;恢复后需重新生成凭据再启用。

「创建应用/编辑配置」支持与管理员应用接入一致的图标、客户端类型、回调地址、权限范围、默认绑定数量和解绑冷却。图标可上传,管理员允许时也可填写外部链接。机密客户端还可开启「兼容不发送 nonce 的 OIDC 应用」或「传统 OIDC 客户端兼容(不发送 PKCE / nonce)」;默认关闭,保存后立即生效。公开客户端必须使用 PKCE,不能启用这两项兼容设置。仅缺少 nonce 时使用第一项,接入方连 PKCE 也不支持时才使用第二项。

应用只提供软件更新时,关闭「启用 OAuth / OIDC 登录」,无需填写回调。需要登录时填写精确回调和 scope,推荐授权码 + PKCE S256、随机 state 和 nonce。桌面/移动端使用公开客户端,服务端机密客户端在后端保存密钥。平台自身的第三方登录方式由运营后台「第三方登录」配置,开发者应用不需要单独收集平台用户密码。

发布更新

  1. 进入「版本更新」,选择自己的应用,创建版本。平台、架构和通道共同确定更新目标;递增版本序号用于比较更新。
  2. 填写更新说明及强制更新要求。草稿可以编辑,平台/架构/通道不可修改,目标改变时新建版本。
  3. 网页上传安装包,单文件最大 128 MiB。上传支持分片、暂停、同文件续传和取消;服务端校验完整文件 SHA-256。也可使用该应用的工具凭据从构建流水线上传。
  4. 上传完成后手动发布或选择本地时间定时发布。已发布/定时版本先取消再编辑;已公开过的安装包和版本标识不可替换,修复软件应创建新版本。
  5. 在「接入指南」选择平台、架构、通道和当前版本序号执行在线检测。该操作实际调用更新 API。公开客户端只需 Client ID,不需要 Secret。
  6. 客户端展示返回的说明与 mandatory 要求,下载安装包后验证 size 与 SHA-256,通过校验后再安装。下载链接短时有效;取消发布后更新接口不再返回该版本。

示例:

GET /api/v1/updates/check?client_id=应用ClientID&platform=windows&arch=x64&channel=stable&version_code=0

响应 data.update_available=true 时,data.release 包含版本、说明、强制更新、文件大小、摘要及 download_url。下载路径返回短时 S3 重定向。完整协议可查看「软件版本与安装包」「机器版本接口参考」。

工具凭据可设名称、有效期、权限,签发时只显示一次;支持轮换、吊销和调用审计。机器不能发布 stable 正式通道,正式发布在 Web 或小程序中确认。

自带 S3

套餐包含自带 S3 时,进入「自带 S3」新增公网 HTTPS Endpoint、Region、Bucket 和密钥。目标限 HTTPS 443,禁止内网、回环地址和重定向。密钥加密保存,编辑时留空保留旧值。

先测试上传、读取和删除,再到「我的应用」绑定配置。若诊断提示待清理对象,使用存储服务商控制台清理指定测试对象。浏览器分片直传还需要 Bucket CORS:允许本站 Origin、PUT/GET/HEAD、签名请求头,并暴露 ETag;后端连接诊断不能替代浏览器 CORS 检查。

已有目标的 Endpoint、Region 和 Bucket 不可原地改变;迁移目标时新增配置再绑定,旧文件继续使用原存储。套餐到期后可修复已有密钥并清理文件。存储文件列表包含上传中、可用及清理中的占用,进入所属版本取消发布并删除,后台成功清理后释放额度。自带 S3 的服务商费用另行支付,仍遵守平台配置的存储额度。

历史版本停止续费

管理员在「开发者运营 → 套餐与资源包 → 变更记录」展开历史订阅配置,可单独「停止此版本续费」或恢复,并在确认前查看绑定该版本自动续费的账户数。当前配置仍通过套餐上下架控制;关闭旧版本续费不会影响新版本售卖。归并进来的旧套餐使用原版本的统一续费状态。

停止后,已有权益与已创建订单保留,原版本不再自动扣款续费。受影响用户收到站内通知,并在「消费设置」看到原因和当前套餐的价格、权益。用户须选择并保存确认新配置,平台不会自动改价或代替用户接受新条款。恢复后,仍保留原版本续费设置的账户可继续按原价格、原权益续费。

小程序同步

「我的」显示会员与权益并提供开发者入口。小程序与 Web 共用套餐、订单、应用、版本和 S3 配置,支持体验领取、购买/续费、更新检测、版本说明/强制更新、定时发布/取消/清理、工具凭据及审计。安装包通过 Web 或机器接口上传,小程序可随后审核发布。小程序源码和构建版本同步为 0.3.0,提交微信审核属于独立发布流程。