云端会员系统 - 接口文档

面向应用开发者的 API 参考
未找到匹配的接口
2026-09-27
新增应用「天地图」配置:云端代理调用,密钥 tk 不下发
  • 管理端「应用管理 → 编辑应用」新增天地图页(按应用独立配置):开关、密钥 tk(AES-256-GCM 加密存储,回显仅脱敏显示)、允许代理服务勾选、每日调用总上限、备注
  • 新增管理端接口:GET/PUT /api/admin/apps/:id/tianditu-config;tk 留空表示不修改
  • 新增应用端接口:GET /api/v1/tianditu/:service?参数(需登录),云端代理转发并在服务端拼接 tk,支持地理编码、地点检索、驾车/公交/步行路线、静态地图、瓦片;客户端自带 tk 一律剔除,JSON/图片原样透传,白名单+日限+限流多重防护
2026-09-22
新增应用「积分管理」:可配置获取/消耗积分规则,应用端按规则调用
  • 管理端「应用管理 → 编辑应用」新增积分管理页(按应用独立配置):可增删改「获取积分」与「消耗积分」两类规则,每条含行为名称、行为代码、积分数、启用状态;保存为对账式(自动新增/更新/删除)
  • 新增管理端接口:GET/PUT /api/admin/apps/:id/points-rules;规则删除不影响历史流水
  • 新增应用端接口:GET /api/v1/member/points/rules 查启用规则;POST /api/v1/member/points/grant 按 code 获取积分(60天有效)、POST /api/v1/member/points/consume 按 code 消耗积分(不足报错、临期批次先扣),均写入积分流水,支持 ref_no 幂等防重
2026-09-20
反馈附件改回 R2 存储,并启用「反馈附件专用 Bucket」
  • R2 配置(r2_storage_config)新增两个字段:feedback_bucket(反馈附件专用 Bucket,与分享文件业务 Bucket 独立)与 feedback_domain(该 Bucket 的访问域名);需在 Cloudflare 先创建 Bucket 并绑定独立自定义域名后,到应用配置「R2」页填写保存
  • POST /api/v1/member/feedback/attachment:附件存入反馈专用 Bucket(路径 feedback/{app}/{member}/{uuid}),未配置专用桶时返回 400;接口字段与调用方式不变
  • 管理端应用编辑弹窗「R2」页新增反馈专用 Bucket / 域名配置项;已有的本地附件将迁回 R2
2026-09-19
新增「建议反馈」:投诉/建议/BUG/想法,管理端回复、用户登录可见
  • POST /api/v1/member/feedback(会员态,限流 10 次/分):提交反馈,category 取值 complaint=投诉 / suggestion=建议 / bug=BUG / idea=想法;应用前端可自行决定只展示某类(如「提想法」固定传 idea),content 1-2000 字
  • GET /api/v1/member/feedback(分页)/ GET /api/v1/member/feedback/:id(详情):用户登录后查看自己的反馈与管理员回复,status=1 已回复时 reply_content/reply_at 非空;仅能查看本人反馈
  • 管理端左侧菜单新增「建议反馈」页:按应用/类别/状态/关键词筛选,支持回复与修改回复(POST /api/admin/feedbacks/:id/reply),回复后用户在应用内登录即可看到
  • 管理端菜单「建议反馈」新增待回复数量角标(GET /api/admin/feedbacks/pending-count,登录后加载并每 60 秒自动刷新,回复成功即时更新,超 99 显示 99+)
  • 反馈支持附件:新增 POST /api/v1/member/feedback/attachment(multipart,file 字段,图片/文档/压缩包/音视频 ≤10MB,存应用 R2);fb-submit 新增 attachments 参数(附件ID数组,最多3个,先传后绑);fb-list/fb-detail 响应新增 attachments 字段;管理端列表与回复弹窗可查看附件
  • 提交限额:每个用户每天最多提交 3 条反馈(所有类别合计,按北京时间日历天),超出返回 429
  • 数据库新增表 app_feedback_attachments(启动自动迁移)
  • 数据库新增表 app_feedbacks(启动自动迁移)
2026-09-18
零知识跨端同步上线 + 微信小程序第三方平台会员自助接口
  • 零知识跨端同步(剪贴板 + 待办):新增 5 个会员态接口,桌面端与小程序在同一会员身份下共享同一同步空间。所有内容均为端到端加密的不透明密文,平台只中转/存储密文与版本号,不持有密钥、不可读:POST /api/v1/sync/clipboard/push、GET /api/v1/sync/clipboard/pull(单槽最新覆盖,Redis 7 天 TTL,毫秒 version + after_version 游标);POST /api/v1/sync/todos/push(client_batch_id 幂等、单批≤100、墓碑删除)、GET /api/v1/sync/todos/snapshot(全量快照)、GET /api/v1/sync/todos/delta(since_version 增量、单页 200、need_snapshot 缺口回补)
  • 待办同步模型:变更日志只追加、日志自增 id 即全局版本号;当前态表按 client_item_id upsert;变更日志/墓碑/批次保留 30 天,到期由云端每小时自动清理(snapshot 全量回补,不影响长期使用)
  • 微信小程序(第三方平台代开发)会员自助接口:新增 GET /api/v1/mini-program/auth-url(扫码授权链接)、GET /mini-program/status(绑定/授权状态)、POST /mini-program/register(个人主体代注册)、GET /mini-program/register-status(代注册轮询)、POST /mini-program/update(触发版本更新部署)、GET /mini-program/update-status(部署进度),以及公开接口 POST /api/v1/mini-program/bind-login(小程序用一次性 bind_code 兑换会员 Token)
2026-09-15
新增「通知」:富文本通知公告,区分游客/登录会员可见
  • 管理端「编辑应用 → 通知」新增配置:多条通知,含标题、富文本(HTML)内容、可见范围(所有人/仅未登录/仅登录后)、状态、发布时间(apps 新增 notice_config JSON 列,启动自动加列)
  • 新增 GET /api/v1/app/notices(X-App-Id 免登录,登录用户带 Bearer Token):按登录态与 visible 自动过滤,返回 logged_in 与富文本通知列表,每条含唯一 id 供去重/已读标记
2026-09-14
「相关下载」新增限会员下载
  • 管理端「编辑应用 → 相关下载」每项新增「限会员下载」开关(apps.downloads_config 数组每项增加 login_required 布尔字段)
  • 应用端 GET /api/v1/app/downloads(X-App-Id 免登录)返回每项新增 login_required:true 表示该项下载前应用端须先校验登录态(未登录引导登录/开通会员),false/缺省游客可下载
2026-09-14
「相关下载」新增分类
  • 管理端「编辑应用 → 相关下载」每项新增「分类」文本输入(同名自动归并,留空为未分类),随应用保存(apps.downloads_config 数组每项增加 category 字段)
  • 应用端 GET /api/v1/app/downloads(X-App-Id 免登录)返回每项新增 category 字段,并支持可选参数 category 按分类精确筛选(传「未分类」匹配未填分类的项),可与 platform 组合
  • 新增 GET /api/v1/app/download-categories(X-App-Id 免登录):按启用下载项聚合去重返回分类数组(保持配置顺序,未填归为「未分类」),可选 platform 先筛平台
2026-09-14
R2 大文件分片直传上线(>10MB,支持断点续传)
  • 应用端新增 5 个接口(均需 Bearer token,应用已配置并启用 R2):POST /api/v1/member/share-file/multipart/init(初始化,file_size 必须 >10MB)、/parts(批量签发分片预签名 PUT URL,每批最多 200 片、URL 1 小时有效,可重复签发)、/status(查询 R2 已确认分片,断点续传依据)、/complete(合并并入库)、/abort(取消并释放分片)
  • 固定 10MB/片,客户端持预签名 URL 直传 Cloudflare R2,文件流量不经过业务服务器,最大支持约 97GB(10000 片);≤10MB 文件继续走原 POST /api/v1/member/share-file 简单上传(接口不变)
  • 断点续传:中断后调 status 接口取回 R2 已收到的分片号(服务端以 R2 ListParts 为权威进度,不信任客户端自报),仅对缺失分片重新取预签名 URL 续传,已传分片不重传;预签名 URL 过期可重复签发
  • 安全与配额:初始化容量预检 + 完成前复检当月分享容量;完成时 HEAD Object 核对 R2 实际大小必须等于初始化声明值,不一致则删除对象并拒绝入库,防止伪造大小绕过等级容量限制
  • 后台新增每周自动清空已删除记录(物理硬删 app_share_files 中 status=0 的记录,R2 对象此前已随软删除移除),Redis 按 ISO 周加锁保证多服务进程每周只执行一次;同时自动中止超过 7 天未完成的分片上传并清理会话,避免 R2 分片存储泄漏
2026-09-12
AI 队列稳定性优化(对应用端接口无改动)
  • 云端 worker 改为单条精确调度,执行中任务计数与队列内部待确认数严格对齐;修复网关进程异常退出后遗留消息无法被自动回收的兼容性问题,宕机恢复后约 90 秒内死信自动重新认领处理,不会重复扣分
  • 排队任务取消(status=5/canceled)、失败重试、动态并发等既有机制不变,应用端无需任何改动
2026-09-12
AI 处理队列升级:任务可被云端取消,轮询新增 status=5
  • 云端管理端新增 AI 处理队列管控(对应用端透明):排队中的任务可由管理员取消,GET /api/v1/ai/tasks/:task_id 轮询新增 status=5 / status_text="canceled" 终态;取消发生在执行与扣分之前,不扣积分,引用的上传文档同步释放
  • 已开始执行的任务不可取消;status 枚举更新为 0待入队 / 1排队中 / 2处理中 / 3成功 / 4失败 / 5已取消
  • 云端队列稳定性优化:失败重试退避期间不再占用 worker 处理槽、worker 并发支持云端热调整,对应用端接口无任何改动
2026-09-12
AI 网关:多模型服务商容灾 + 应用端接口收敛为两大功能
  • 多模型服务商容灾:管理端「编辑应用 → AI网关」可配置多个模型服务商,每个服务商独立 Base URL、独立 API Key、独立候选文本模型链;第 1 个为主服务商,主服务商故障(超时 / 上游 5xx / 429 / 网络中断 / 鉴权失败)时云端自动切换到下一服务商,同一服务商内主模型故障先自动换候选模型;切换成功后粘性使用,全部失败再任务级重试,对应用端完全透明
  • 应用端接口收敛为两大功能:新增 POST /api/v1/ai/classify(内容自动 AI 分类)与 POST /api/v1/ai/summarize(AI 总结文档/文字摘要);两个接口均同时支持 application/json 传文本与 multipart/form-data 直接传文档文件(file 字段,最多 5 个),也可配合 file_ids 使用已上传文档
  • 下线对外配置/通用接口:GET /api/v1/ai/config、GET /api/v1/ai/pricing、POST /api/v1/ai/tasks(通用 action 提交)、POST /api/v1/ai/embeddings 不再开放;保留 POST /api/v1/ai/files(文档换 file_id)与 GET /api/v1/ai/tasks/:task_id(轮询结果)。应用端不感知、也无法获取任何服务商/密钥/模型信息
  • 任务模式、计费(分类 1 积分;摘要基础 1、每超 1000 字 +1、封顶 10)、request_id 幂等、24h 同内容去重、成功才扣分、任务终态自动删档等机制不变
2026-09-12
AI 网关多模型容灾 + 应用端配置收口(统一接口不变)
  • 多模型链与自动故障切换:管理端可为每类能力(文本/视觉/向量)配置多个模型并指定默认主模型;主模型出现超时、上游 5xx、429 或网络中断时,云端自动按顺序切换下一个候选模型,切换后粘性使用;鉴权失败、400 参数错误不做无意义切换。对外接口路径、请求与响应结构完全不变,应用端无需也无法指定模型
  • 安全收口:GET /api/v1/ai/config 不再下发 model_pool/text_model/vision_model/embedding_model/config(base_url、has_api_key)等任何 AI 配置,仅返回 enabled 与 file_max_mb;任务提交/轮询响应移除内部 model 字段。应用端只提交内容、获得 AI 结果(如文档摘要),密钥与模型拓扑完全由云端保管
  • 实际成功使用的模型(含故障切换后的候选模型)仅记录在管理端任务流水中,用于运维排查;任务级自动重试(最多 2 次)保持不变,重试时整条模型链重新从主模型开始
2026-09-11
新增 AI 网关:云端统一调用 OpenAI 兼容模型,按次扣积分
  • 新增独立 AI 网关服务(同域路径 /api/v1/ai/,需登录 Bearer token),应用在管理端「编辑应用 → AI网关」单独配置后可用:支持自动分类 classify、文档摘要 summarize、内容重写 rewrite、标签/实体抽取 extract、图片理解 vision、语义向量 embeddings 共 6 类能力
  • 新增 GET /api/v1/ai/config(能力配置与模型池、文件上限,未开通也可查询)、GET /api/v1/ai/pricing(当前应用生效的积分定价表)
  • 新增 POST /api/v1/ai/files:multipart 上传文档/图片换取 file_id(单文件默认 20MB,硬上限 25MB,仅本人可用)
  • 新增 POST /api/v1/ai/tasks:提交异步任务(支持 request_id 幂等、同会员同内容 24 小时去重、提交时估价并校验余额、日消耗上限与并发上限),GET /api/v1/ai/tasks/:task_id 轮询结果;任务成功才扣积分,失败不扣,引用文件任务终态后自动删除
  • 新增 POST /api/v1/ai/embeddings:同步语义向量化(单次最多 64 条,按次扣 1 积分)
  • 默认定价:分类/抽取/向量 1 积分;摘要基础 1、每超 1000 字 +1、封顶 10(前 2000 字免费);重写基础 2、每超 500 字 +1、封顶 20(前 1000 字免费);图片 2 积分/张。管理端可按应用覆盖定价
2026-09-09
瞬传别名:应用内会员别名映射(不能用于登录)
  • 应用端会员可设置/修改/删除自己的「瞬传别名」(POST /api/v1/member/alias、DELETE /api/v1/member/alias),别名应用内唯一,2-20位,支持中文/字母/数字/下划线/横线;别名仅关联会员账号,不能用于登录
  • 新增 GET /api/v1/member/lookup?alias= 免登录接口(X-App-Id 头识别应用),通过别名查找会员,返回 username/app_user_id,实现「别名→会员名称」映射;GET /api/v1/member/info 和 /member/sync 响应新增 alias 字段
  • 管理端「编辑应用 → 会员管理」表格新增「瞬传别名」列,支持按别名搜索
2026-09-09
管理端新增积分统计:按来源汇总余额、近30天明细、30天内到期逐笔
  • 管理端「积分管理」新增「积分统计」:当前可用总积分、30天内即将到期积分及笔数概览;按积分来源(注册赠送/签到/充值/每月赠送/推荐分享/管理员调整/历史迁移)分别汇总可用余额、活跃批次数、近30天发放量,支持按应用筛选;应用端接口无变化
  • 新增管理端接口:GET /api/admin/points/stats/summary(来源汇总)、GET /api/admin/points/stats/source-detail?source=(该来源近30天发放批次明细,逐笔含发放额/剩余/状态/到期/单号,可分页)、GET /api/admin/points/stats/expiring?days=30(N天内即将到期批次逐笔,按到期升序、含剩余天数)
2026-09-09
积分规则升级:有效期 + 过期作废 + 充值/推荐积分统一入账
  • 「每月赠送」积分当月有效、次月1号自动作废不累计;注册/签到/充值/推荐/管理员加积分统一 60 天有效;积分按批次记账,可用余额=所有未到期批次剩余之和
  • 兑换会员等级/扣减积分时,优先扣当月赠送积分、其余按过期时间临期优先(先到期先扣);积分到期作废时自动扣减余额,并在积分明细(GET /api/v1/member/points)写一条「积分过期作废」扣减流水可对账;存量会员现有积分余额统一按 60 天有效迁移
  • 充值积分修复并正式入账:支付成功后按管理端「积分设置-充值奖励每元赠送积分」× 充值元数发放(此前仅记流水不可用,现已计入可用余额,60天有效)
  • 推荐/分享奖励积分支持按应用独立配置(管理端「编辑应用 → 推荐奖励积分」,0=不奖励);GET /api/v1/member/points/recommend-reward 优先返回当前应用配置,未配置回退全局积分设置,推荐积分 60 天有效(接口路径/入参/出参不变)
2026-09-09
会员等级新增「每月赠送积分」(系统每月1号自动发放)
  • 管理端「编辑应用 → 会员等级」各等级新增「每月赠送积分」配置:不同等级可独立设置(0=不赠送),随应用保存
  • 系统每月1号自动按会员当前等级发放,无需应用端调用,发放后实时到账并写入积分明细;按「会员+月份」幂等防重,重复执行不重复发放
2026-09-06
找回密码新增手机号查用户名接口(脱敏确认)
  • 新增 POST /api/v1/auth/forgot-password/lookup-username:输入手机号返回该会员用户名(脱敏 f****1,支持中文);会员不存在统一返回 has_username=false 防枚举;限流5次/分
  • 用途:重置密码时输入手机号 → 显示脱敏用户名让用户确认没输错 → 再发码重置;仅用于找回密码确认场景,不用于注册
2026-09-06
找回密码支持用户名方式:新增 lookup 接口,发码/重置支持传 username
  • 新增 POST /api/v1/auth/forgot-password/lookup:输入用户名返回绑定手机号(脱敏 139****0001);用户不存在/未绑定统一返回 has_phone=false 防枚举;限流5次/分
  • POST /auth/forgot-password/send-code 与 /auth/reset-password 新增 username 入参(与 phone 二选一):后端按用户名解析真实手机号发码/校验,完整手机号不返回前端
  • 推荐前端流程:输入用户名 → 调 lookup 显示脱敏手机号让用户确认 → 获取验证码 → 输入验证码+新密码完成重置
2026-09-06
获取会员信息接口新增 phone_plain 明文手机号字段
  • GET /api/v1/member/info 响应新增 phone_plain 字段:返回明文手机号(未绑定手机号时返回空字符串);无论用户名密码登录还是手机号登录,均可获得该会员的用户名(username,原有字段)与明文手机号(phone_plain)
  • 原有 phone 字段保持脱敏返回不变,现有字段与功能不受影响,纯新增方式
2026-09-06
新增 R2 分享限额查询接口(最长删除时间/当月容量)
  • 新增 GET /api/v1/member/share-limits(需登录):按会员当前等级返回管理端「编辑应用 → R2对象存储 → 分享容量与有效期」配置,返回 level_code/level_name/max_ttl_hours(最长删除时间,小时,0=不限)/quota_mb(当月容量上限,0=不限)/used_mb/remaining_mb(不限为 -1)
  • POST /api/v1/member/share-file 上传限额修复:免费会员(未显式设置等级,level_code 为空)此前匹配不到等级限额配置,现按应用第一个启用的免费等级取限额(与可使用数量接口口径一致),等级限额对默认等级会员生效
2026-09-06
同一应用内会员手机号唯一化校验
  • POST /api/v1/auth/register 带手机号注册时,新增应用内唯一校验:该手机号已被本应用其他会员注册/绑定时返回 409「该手机号已被注册」
  • POST /api/v1/member/bind-phone 绑定手机号校验收紧为应用内唯一:不允许绑定本应用其他会员已绑定的手机号(返回 409「手机号已被绑定」);不同应用仍可绑定同一手机号(自动关联同一全局会员)
  • POST /api/v1/auth/register/send-code 发送注册验证码的占用校验统一口径:不区分会员状态,禁用会员同样占用手机号;已有接口 change-phone 系列、管理端改号此前已按应用内唯一校验,行为不变
2026-09-06
新增「支付宝网页支付(AI付/电脑网站支付)」收款渠道 alipay_web
  • 新增支付渠道 alipay_web:底层为支付宝 alipay.trade.page.pay 电脑网站支付(AI网页应用收款),创建升级订单 POST /api/v1/member/upgrade 传 channel=alipay_web 时返回 pay_url 收银台地址,应用用浏览器/WebView 打开付款;alipay 支付宝扫码渠道继续保留并返回二维码,两种渠道互不影响
  • 收银台固定使用「仅扫码支付」模式(qr_pay_mode=4 嵌入式二维码,qrcode_width=300):打开页面只展示二维码,由用户用支付宝 App 扫码完成付款,不提供「登录账户支付」入口,适配桌面端/窗口扫码场景
  • alipay 扫码渠道底层由「当面付 alipay.trade.precreate」切换为电脑网站支付前置模式(AI付未签约当面付,precreate 会报 40004 ACCESS_FORBIDDEN):服务端从前置模式收银台页面提取支付宝官方收款码(qr.alipay.com/xxx)作为二维码内容返回,App 展示与扫码交互完全不变。注意:扫码提示 AE150003030「系统有点忙/可以在电脑上付款」表示付款账号与收款账号为同一支付宝账号(自己付自己),请换一个支付宝账号扫码
  • 创建支付订单 POST /api/v1/payment/create 的 channel 同步支持 alipay_web;支付方式列表 /api/v1/member/level/payment-methods 返回值新增 alipay_web,管理端「编辑应用 → 会员等级收款方式」可勾选「支付宝网页支付(AI付)」
  • 支付宝异步回调 POST /api/v1/payment/alipay/notify 升级为表单解析 + RSA2 验签 + app_id/金额/幂等校验(退款事件自动排除),成功返回纯文本 success
  • 新增 GET /api/v1/pay/return 网页支付付款完成后的同步回跳结果页(HTML 落地页);查单接口内置 alipay.trade.query 主动查单兜底,异步通知丢失时轮询查单也能自动到账
  • 管理端「系统设置 → 支付配置」新增可选「网页支付回跳地址」(alipay_return_url,留空按回调域名自动推导,默认 https://member-api.33765.cn/api/v1/pay/return)
2026-09-04
相关下载新增「说明」字段
  • 管理端「编辑应用 → 相关下载」每项新增「说明」文本输入框(可选),用于描述版本特性、适用系统等;随应用保存(apps.downloads_config 数组每项增加 description 字段)
  • 应用端接口 GET /api/v1/app/downloads 返回数据同步新增 description 字段,客户端可一并引用展示
2026-09-03
新增「相关下载」配置与应用端接口
  • 管理端「编辑应用 → 相关下载」新增配置:下载项包含 名称、平台、下载地址、版本号、文件大小、状态(启用/禁用),多个下载项可增删,随应用保存(apps.downloads_config)
  • 新增应用端接口 GET /api/v1/app/downloads(X-App-Id 免登录):返回该应用所有启用状态的下载项;可选参数 platform 按平台筛选(如 windows/macos/android/ios/web,命中项 platform 字段含该值即返回),客户端可在下载页按平台展示对应安装包/App
2026-09-03
注销账号支持短信验证码(可选)
  • 新增 POST /api/v1/member/delete-account/send-code 发送注销账号验证码到会员绑定手机号(需登录;未绑定手机号返回400);返回 data.scenario 场景码 = sms_delete_account,需在管理端「编辑应用 → 短信配置」为该场景码绑定阿里云短信模板后即可真实发送
  • POST /api/v1/member/delete-account 新增可选参数 code(非必填):传了则校验注销验证码(错误/过期返回400),不传则直接注销(保持原行为兼容);验证码有效期内一次性使用
2026-09-03
新增「短信使用量」:会员等级配置短信模板并限额,应用端按使用量发送短信
  • 管理端「编辑应用 → 会员等级」每个等级新增「短信使用量」配置:短信模板(复用应用短信配置中的场景码)、限额方式(每月使用量 / 总使用量,二选一)、使用量上限(0=不限)
  • 每月使用量:按自然月统计,每月 1 日自动恢复,当月用不完不累积到下月;总使用量:累计统计,用完即止,不设有效期
  • 新增应用端接口(需登录,token 为 app_member):GET /api/v1/app/sms-usage(查询当前会员短信使用量配置与已用量);POST /api/v1/app/sms-usage/send(按会员等级配置的短信模板发送短信,发送成功计 1 条使用量,发送失败不计)
  • 发送接口允许客户端传 params(短信模板变量),透传给阿里云模板参数 TemplateParam;超额时返回 429(monthly:本月短信使用量已用完;total:短信使用量已用完),并发下通过数据库行锁防超发
  • 支持多模板场景:每个等级的「短信模板」可填多个场景码(逗号分隔,如 sms_register,sms_bind_phone),所有场景共用同一使用量限额;发送接口新增可选参数 scenario 指定用哪个模板(不传默认第一个),传了未配置的场景返回 400;查询接口返回 template_scenarios 场景数组
  • 发送接口校验会员状态与等级是否到期:账号被禁用(status≠1)返回 403「账号已禁用」;会员等级到期未续费时实时降级为免费等级,按当前有效等级计算配额
2026-08-31
新增「R2分享」全局管理菜单与上传路径归档
  • 管理端左侧菜单新增「R2分享」,记录所有通过 R2 上传并分享的文件,支持按应用/会员/状态筛选、分页,展示应用名称、会员账号(用户名/手机号)、文件名、大小、访问地址、上传/到期时间
  • 支持「暂停/恢复」:暂停时 R2 对象从 share/... 移动至 paused/share/...,原公开访问地址立即 404;恢复后移回原路径,地址重新生效
  • 支持「删除」:删除 R2 对象(无论 share/ 或 paused/ 位置)并标记记录已删除,访问地址永久失效
  • 应用端上传路径改为 share/{appId}/{memberId}/{yyyy}/{MM}/{时间戳}{扩展名}(按上传年月归档,新上传生效,历史记录不受影响)
  • 到期自动清理逻辑同步覆盖已暂停文件(status=1/2),暂停不影响到期时间
2026-09-01
补齐应用端「文档有、代码无」接口 + 管理端「文章字段配置」保存落库
  • 补齐实现并注册一批文档已有但代码未实现的应用端接口(均实测可用):GET /api/v1/member/points/signin-reward(签到奖励积分)、GET /api/v1/member/points/recommend-reward(推荐奖励积分)、GET /api/v1/member/points/settings(积分设置:签到/充值奖励积分)、GET /api/v1/member/sync(会员状态同步)、POST /api/v1/member/delete-account(注销账号)、GET /api/v1/member/level/payment-methods(等级支付方式)、GET /api/v1/app/article-categories(及 /:id 分类详情)、GET /api/v1/app/articles(及 /latest、/:id)、GET /api/v1/app/article-field-config(文章字段配置)、GET /api/v1/app/tutorial-categories、GET /api/v1/app/tutorials
  • 接口状态澄清:GET /api/v1/member/points/settings 为当前有效接口(X-App-Id 免登录,返回 signin_reward/recharge_reward);GET /api/v1/member/points/config 已废弃(不再注册,由 signin-reward / recommend-reward 替代)
  • 管理端「文章管理 → 字段配置」保存落库修复:文章字段配置(apps.article_field_config)此前管理端保存不生效、回显为空,现已完整落库(GET/PUT /api/admin/apps/:id 读写该字段),应用端 GET /app/article-field-config 实时读取
2026-09-01
R2「分享文件」支持按会员等级限制分享使用容量与最长删除时间
  • 管理端「编辑应用 → R2对象存储」新增「分享容量与有效期(按会员等级)」配置:分享使用容量(当月累计分享到R2的容量上限MB,0=不限)、最长删除时间(分享文件保留时长上限小时,0=不限制),随 r2_storage_config.share_limits 保存
  • 分享使用容量:POST /api/v1/member/share-file 上传时校验该会员当月累计容量(有效+暂停,排除已删除),超出返回 403
  • 最长删除时间:上传时 expires 按会员等级封顶(用户选择/默认时长超过上限时按上限截断),到期仍由后台定时任务自动删除
2026-08-31
新增 Cloudflare R2 对象存储「分享文件」
  • 管理端「编辑应用 → R2对象存储」新增配置:启用开关 / Account ID / Access Key ID / Secret Access Key / Bucket / 访问域名,支持「测试连接」,与「云存储(腾讯云COS)」相互独立
  • 新增 POST /api/v1/member/share-file 分享文件接口(需登录):文件自动上传到该应用的 R2 存储桶并返回公开访问地址,单文件上限 50MB
  • 支持自动删除时间 expires:可选 1/2/3/6/12/24 小时(缺省 24),到期由后台定时任务自动删除(每分钟扫描)
  • 管理端新增已分享文件列表:GET/DELETE /api/admin/apps/:id/share-files(列表/手动删除,删除同步移除 R2 对象)
  • 管理端「R2对象存储」支持测试上传文件:POST /api/admin/apps/:id/r2/upload-test(可携带 file 或自动生成默认测试文件,测试对象 10 分钟后自动删除)
2026-08-29
版本升级「升级说明」支持富文本编辑
  • 管理端「编辑应用 → 版本升级」点击「升级说明」输入框弹出富文本编辑器(加粗/斜体/下划线/列表/标题/链接/清除),支持富文本编辑升级说明,内容以 HTML 存入版本 description 字段
  • 应用端版本接口不变:GET /api/v1/app/versions 与 /versions/latest 仍返回 description 字段,应用端按富文本渲染展示即可
2026-08-29
新增「应用协议」配置与应用端接口
  • 管理端「编辑应用 → 协议设置」新增 用户协议、隐私政策、服务协议 三份协议,支持富文本编辑(HTML,存储于 apps.agreements)
  • 新增应用端接口 GET /api/v1/app/agreement/:type(X-App-Id 免登录):三份协议分别单独调用(type=user/privacy/service),返回富文本 HTML 内容
2026-08-29
获取会员信息接口返回「升级推荐文案」
  • GET /api/v1/member/info 响应新增 upgrade_copy 字段:按会员当前状态返回「升级推荐文案」(state=free/limited/unlimited、copy=匹配当前状态的文案、upgrade_copy=三态文案全集),与应用端独立接口 GET /api/v1/member/upgrade-copy 结构一致,应用端一次获取会员信息即可直接展示升级推荐文案
2026-08-29
新增「升级推荐文案」配置与应用端接口
  • 管理端「编辑应用-会员等级」新增「升级推荐文案」配置:免费用户 / 有限时长收费会员 / 无限时长收费会员 三种状态文案独立填写(存储于 apps.upgrade_copy)
  • 新增应用端接口 GET /api/v1/member/upgrade-copy(需登录):按会员当前状态返回对应文案(state=free/limited/unlimited,copy=匹配当前状态的文案,upgrade_copy=三态文案全集),应用端可直接展示
2026-08-29
积分管理新增「注册赠送积分」配置
  • 管理端「积分管理 → 积分设置」新增「注册赠送积分」配置项(默认0=不赠送)
  • 新会员注册成功并登录后直接赠送对应积分(仅注册时一次,不阻断注册流程),积分记录类型为「注册赠送」
  • PUT /api/admin/points/settings 与 GET /api/admin/points/settings 新增 register_reward 字段
2026-08-29
获取会员信息接口新增「可使用数量」多项目绝对量
  • GET /api/v1/member/info 响应新增 usage_quantity 字段:返回会员当前等级「可使用数量」多项目绝对量(name/limit/reported/remaining,默认端 windows),与应用端独立接口 GET /api/v1/member/usage-quantity 结构一致,应用端一次获取会员信息即可同时拿到各项目可使用数量绝对量
2026-08-28
「可使用数量」升级为多项目(最多5项)+ 桌面端子平台 + 上报接口
  • 会员等级「可使用数量」支持多个项目(如 A项/B项/C项,最多5项),每个项目独立配置数量上限,不同等级可不同
  • 应用端上报接口 POST /api/v1/member/usage-quantity/report:使用绝对量方式上报,关联不同端(桌面端子平台 windows/macos/android/harmonyos 及 web/miniprogram/app/server,默认 windows)
  • GET /api/v1/member/usage-quantity 升级:支持 platform 参数(默认 windows),返回多项目 items(name/limit/reported/remaining)
  • 编辑应用-应用类型「桌面端」增加子平台:windows、macOS、Android、HarmonyOS(非必选,默认 windows),保存到应用 desktop_platforms 字段
2026-08-28
会员等级新增可使用数量限制(独立应用端接口)
  • 会员等级可配置「可使用数量」:不同等级可设不同上限(0=不限),供应用端引用并按等级限制可使用数量
  • 新增独立接口 GET /api/v1/member/usage-quantity:返回会员当前等级的可使用数量 usable_quantity 与剩余数 remaining_quantity
2026-08-28
新增会员云存储(腾讯云COS)
  • 新增 POST /api/v1/member/cloud-storage/backup 上传配置备份到COS(按会员ID作为目录,应用需开启腾讯云COS云存储)
  • 新增 GET /api/v1/member/cloud-storage/backups 云存储备份列表
  • 新增 GET /api/v1/member/cloud-storage/backup/latest 获取最新备份内容
  • 新增 DELETE /api/v1/member/cloud-storage/backup/:id 删除备份(同步删COS对象)
  • 新增 GET /api/v1/member/cloud-storage/usage 云存储使用容量
  • 新增 GET /api/v1/member/cloud-storage/quota 云存储容量配额(跟随会员当前等级,可开启「限制会员使用容量」实时限制上传)
  • 管理端「编辑应用-云存储」新增「云存储方式-腾讯云COS」配置(SecretId/SecretKey/Bucket/Region + 测试连接)
2026-08-24
删除「自定义数据」全链路
  • 删除「自定义数据」全链路:管理端接口/页面/弹窗/JS 与应用端接口、模型、状态定义全部移除,历史 changelog 条目保留
2026-08-24
接口契约保护机制与可视化监控
  • 新增 internal/contract 接口契约清单(单一事实源):声明 vs 实际注册启动自检,防止修改某个接口误伤其他接口
  • 新增:GET /api/admin/system/contract-status 管理端契约自检状态(需登录,返回声明/注册/缺失/漏网/格式校验)
  • 新增:GET /api/v1/contract/status 应用端契约自检状态(公开只读)
  • 管理端左侧菜单新增「接口契约」可视化页,可切换查看应用端/管理端接口清单
2026-08-20
会员列表等级展示与排序
  • 管理端会员列表「正使用应用」后新增「会员等级/过期时间」列(GET /api/admin/members 新增 apps_detail 数组,含每应用 app_name / level_code / level_name / member_type / expires_at)
  • 编辑应用-会员管理列表的 等级 / 积分 / 过期时间 表头支持点击排序
2026-08-20
管理端会员详情等级展示与到期扫描
  • 管理端 GET /api/admin/members/:id 会员详情 app_members 新增 app_name / level_name 字段,展示会员在各应用的等级与到期时间
  • 新增管理端 POST /api/admin/members/:id/scan-expiry 扫描更新到期时间,手动触发该会员全部应用账号的到期降级检查
2026-08-20
应用端接口兼容性与新增
  • GET /api/v1/member/points 新增 ?legacy=1 兼容返回旧版 data 数组格式,旧版应用端无需改对接继续可用
  • GET /api/v1/levels/benefits 同步保留 values(✓/—) 旧判据与新增 checked_levels / unchecked_levels 字段,向后兼容
  • 实现 GET /api/v1/app/versions 与 GET /api/v1/app/versions/latest(X-App-Id 免签)
2026-08-20
补齐应用端版本查询接口
  • 实现 GET /api/v1/app/versions 与 GET /api/v1/app/versions/latest(X-App-Id 免签),读取 app_versions 表 status=1 数据;latest 无版本返回 404「暂无版本」
2026-08-19
新增会员自己的升级订单与积分明细接口
  • 新增 GET /api/v1/member/upgrade/orders 获取当前会员已支付成功的升级订单列表(分页,含等级、金额、支付渠道、支付时间)
  • GET /api/v1/member/points 升级为分页的积分增减明细(points 正负表示增/减,type 1=增加 2=减少,balance 为变动后余额),仅返回当前会员自己的明细
2026-08-19
等级权益说明接口区分勾选/未勾选状态
  • GET /api/v1/levels/benefits 每条说明新增 checked_levels(勾选关联的等级代码集合)与 unchecked_levels(未勾选的等级代码集合)
  • 勾选与未勾选的说明标题均会返回,应用端据此明确区分勾选/未勾选状态
2026-08-19
等级权益说明改为统一配置 + 勾选关联等级
  • 管理端「编辑应用 → 会员等级」新增「统一等级权益说明」配置:编写标题+内容,勾选关联等级(一个等级可关联多条说明)
  • 移除每个等级各自独立的权益说明字段(不再使用 level_config[].benefits)
  • 新增存储字段 apps.benefit_descriptions,随应用保存
  • GET /api/v1/levels/benefits 返回格式重构:每条统一说明一行,关联的等级显示 ✓、未关联显示 —
2026-08-19
获取会员信息接口新增当前版本到期时间
  • GET /api/v1/member/info 响应新增 expires_at 字段(当前版本到期时间)
  • 无限制(长期)时返回字符串「无限制时间」,有限期时返回格式 YYYY-MM-DD HH:MM:SS
2026-08-19
升级权益接口接入真实支付(微信 Native / 支付宝当面付)
  • POST /api/v1/member/upgrade 微信/支付宝支付改为调用支付网关真实下单
  • 响应新增 qrcode_content 字段:二维码原始内容(微信为 weixin:// 开头的 code_url,支付宝为 qr_code 字符串)
  • qrcode_base64 二维码内容修正:不再编码 H5 支付页面 URL,改为编码真实扫码内容,扫码可直接拉起支付
  • 微信支付回调升级为 API v3 格式:验签(WECHATPAY2-SHA256-RSA2048)+ AES-256-GCM 解密 + 自动升级会员
  • 支付配置改为从 system_configs 表实时加载(解密敏感密钥),跨重启持久化,管理端配置后立即生效
  • 支付渠道未配置真实参数时返回明确错误,不再生成无效二维码
2026-08-17
自定义数据功能上线
  • 管理端「应用列表」新增「数据内容」标签页,支持创建自定义数据项、配置字段名、添加/编辑数据内容
  • 支持四种字段类型:text(文本)、icon(图标,自动压缩转base64)、select(单选/多选,支持选项级子字段)、group(分组,支持多条关联字段)
  • 新增 GET /api/v1/app/custom-data 数据项列表接口(X-App-Id 免签名)
  • 新增 GET /api/v1/app/custom-data/:id 按数据项ID获取所有数据内容接口(X-App-Id 免签名)
  • 新增 GET /api/v1/app/custom-data/item/:id 单条数据内容详情接口(X-App-Id 免签名)
  • 数据内容 UI 优化:增加字段间距、改善视觉层次、图标字段预览居中、多记录卡片更大内边距
2026-08-17
使用教程独立菜单 + 文章富文本编辑器 + 首单判定优化
  • 管理端「使用教程」升级为独立一级菜单(原编辑应用内的标签页),支持教程列表、分类管理、搜索筛选
  • 管理端「文章管理」右侧操作区改为标签页模式:文章列表、分类管理、字段配置三个标签页
  • 文章/教程内容支持富文本编辑(加粗/斜体/下划线/标题/列表/对齐/链接/图片),存储格式为 HTML
  • 文章模型新增 type 字段(default=普通文章 / tutorial=使用教程),后端按 type 过滤
  • 首单判定逻辑优化:由「含待支付+已支付订单」改为「仅统计已成功支付的升级权益订单」,待支付订单不再阻止首单优惠
2026-08-20
文章管理重构 + 积分接口拆分 + 文章字段自定义
  • 管理端「文章管理」升级为独立一级菜单(原编辑应用内的「更新日志」标签页),支持跨应用筛选/搜索/排序
  • 文章模型扩展:新增 alias(别名)、source_url(来源URL)、target_url(指向URL)、tags(标签)字段
  • 文章分类新增 type 字段(tutorial=使用教程 / default=其他文章)
  • 新增 GET /api/v1/app/article-categories/:id 单个分类详情接口
  • 新增 GET /api/v1/app/article-field-config 获取应用自定义文章字段名称接口
  • 新增 GET /api/v1/app/tutorial-categories 使用教程分类列表接口
  • 新增 GET /api/v1/app/tutorials 使用教程文章列表接口(支持按分类筛选)
  • 管理端积分设置新增「推荐奖励积分」配置项
  • 移除应用端废弃接口 GET /api/v1/member/points/config
  • 新增 GET /api/v1/member/points/signin-reward 签到奖励积分查询接口
  • 新增 GET /api/v1/member/points/recommend-reward 推荐奖励积分查询接口
2026-08-17
新增积分兑换等级接口 + 等级列表返回积分消耗
  • 等级列表接口 GET /api/v1/levels 返回新增 points 字段(积分消耗,即兑换所需积分)
  • 新增 POST /api/v1/member/level/points-exchange 积分兑换等级接口:使用积分直接兑换会员等级,无需支付
  • 新增 GET /api/v1/member/points/config 获取积分配置(签到积分:每日奖励+连续签到3/10/30天奖励、充值奖励积分),用于应用端展示相关文案,仅需 X-App-Id 请求头
  • 废弃旧接口 GET /api/v1/member/points/settings,由 points/config 替代
2026-08-16
新增会员签到接口
  • 新增 POST /api/v1/member/signin 会员签到:每天限1次,获得奖励积分(积分设置中可配置签到奖励积分,默认1分),重复签到返回 code=1 及 "每日限1次"
  • 移除废弃接口:积分记录 /points/transactions、积分变动 /points/change、积分兑换 /points/exchange、兑换选项 /points/exchange-options(对应功能未实现)
2026-08-16
等级升级全流程改造:levels 接口升级 + 下单出码合并 + 支付后自动升级
  • GET /api/v1/levels 改为需登录(Bearer token),每个等级新增 my_is_first_order/my_applicable_price(首单/续费价,分)/next_code/next_name(下一档标识),一次请求即可获取该用户的"我的价",不再需要单独查 check-order
  • 废弃 GET /api/v1/member/level/check-order/:code 接口,由 levels 接口替代
  • POST /api/v1/member/level/pay 响应新增 qrcode_base64 字段,下单时直接返回二维码 base64 图片,无需再调 qrcode 接口
  • 支付成功后服务端自动更新会员等级(level_code/member_type/expires_at),无需额外操作
  • 首单判定优化:仅统计已成功支付的升级权益订单(status=1),待支付订单不再阻止首单资格
2026-08-16
新增订单支付二维码(base64)接口
  • 新增 GET /api/v1/member/level/pay/qrcode/:order_no 获取订单支付二维码(base64格式图片),桌面端应用可直接用于显示扫码支付
2026-08-16
新增等级升级支付 / 注销账号 / 积分余额接口
  • 新增 GET /api/v1/member/level/payment-methods 获取会员等级升级可用的支付方式(根据应用基础信息中的收款方式配置)
  • 新增 POST /api/v1/member/level/pay 会员等级升级支付:按等级配置价格创建支付订单(首次购买有首购价时使用 first_price),返回二维码供扫码支付
  • 新增 POST /api/v1/member/delete-account 注销当前应用会员账号:删除会员账号及关联的积分记录、订单记录
  • 新增 GET /api/v1/member/points 获取当前会员实时积分余额
2026-08-14
新增免登录持久化功能
  • 新增 GET /api/v1/auth/persist-session 获取免登录会话(桌面端启动时调用,自动续期 token 实现免登录)
  • 新增 POST /api/v1/auth/persist-session/clear 清除免登录会话(桌面端登出时调用)
  • POST /api/v1/auth/login 和 POST /api/v1/auth/register 新增 remember 字段(bool,true 时服务端持久化会话)
2026-08-14
新增应用扩展功能(文章系统/版本升级/云存储)
  • 新增 GET /api/v1/app/article-categories 获取文章分类列表
  • 新增 GET /api/v1/app/articles 全部文章列表(支持 ?category_id=X 按分类筛选)
  • 新增 GET /api/v1/app/articles/latest 最新文章列表(最近10篇)
  • 新增 GET /api/v1/app/articles/:id 文章详情
  • 新增 GET /api/v1/app/versions 版本列表
  • 新增 GET /api/v1/app/versions/latest 最新版本
  • 新增 POST /api/v1/app/cloud-backup 创建云存储备份
  • 新增 GET /api/v1/app/cloud-backups 云备份列表
  • 新增 GET /api/v1/app/cloud-backup/latest 获取最新云备份
  • 新增 DELETE /api/v1/app/cloud-backups/:id 删除云备份
  • 管理端「编辑应用」新增三个标签页:更新日志(文章/分类管理)、版本升级、云存储备份管理
  • 文章/分类/版本接口仅需 X-App-Id(免签名),云备份接口需登录(Bearer token)
2026-08-13
会员信息返回完整手机号
  • GET /api/v1/member/info 与 GET /api/v1/member/sync 的 phone 字段由脱敏号(138****8000)改为返回完整明文手机号;会员未绑定手机号时返回空字符串
  • 应用端可据此展示/使用当前登录会员的手机号码(客户端应用取自己账号数据)
2026-08-13
新增会员账户管理接口(修改手机号/用户名/密码)
  • 新增 POST /api/v1/member/change-phone/send-code 发送修改手机号验证码到当前绑定手机号(场景码 sms_change_phone)
  • 新增 POST /api/v1/member/change-phone/send-new-code 发送验证码到新手机号(确认新手机号可接收短信)
  • 新增 POST /api/v1/member/change-phone 修改手机号:需同时校验原手机号与新手机号验证码,修改后同步更新全局会员手机号
  • 新增 POST /api/v1/member/change-username/send-code 发送修改用户名称验证码(场景码 sms_change_username)
  • 新增 POST /api/v1/member/change-username 修改用户名称:新名称在应用内须唯一,校验短信验证码
  • 新增 POST /api/v1/member/change-password/send-code 发送修改密码验证码(场景码 sms_change_password)
  • 新增 POST /api/v1/member/change-password 修改密码:需同时校验旧密码与短信验证码,修改后清除登录失败锁定记录
  • 所有修改类接口均需登录(Bearer token),需短信验证码验证,验证码使用后立即失效
2026-08-14
Token有效期分层与会员状态同步
  • Token区分为 access_token(2小时)与 refresh_token(30天),登录/注册/刷新接口返回真实 expires_in=7200
  • 免登录机制:客户端持久化保存 refresh_token,启动时静默调用 /auth/refresh 续期,无需每天登录
  • 新增 GET /api/v1/member/sync:一次性返回会员状态、等级配置、权限配置与 version 版本号,前端定时轮询对比 version 即可即时同步会员等级/积分/权限变更
2026-08-14
接口文档审计修正
  • 修正:积分兑换接口参数由 option_id 改为 level_code(与实现一致)
  • 修正:兑换选项响应示例 duration_month 改为 duration_days,移除不返回字段
  • 修正:会员信息/关联应用 level_code 说明(注册默认 free)
  • 补充:需登录接口(绑定手机/支付/积分变动/兑换/发短信)标注 Bearer token 认证;等级列表标注双通道认证
2026-08-14
应用类型与认证方式分层
  • 新增应用类型字段(桌面端/PC Web/微信小程序/移动App/服务端集成)
  • 客户端应用(桌面端/Web/小程序/App):登录、注册、发验证码等预认证接口免签名,请求头仅需 X-App-Id;业务接口改用登录返回的 Bearer token 认证,客户端无需内置 AppSecret
  • 服务端集成(server)应用:继续使用 AK/SK 签名调用所有接口
  • 预认证接口增加限流保护(RateLimit)
2026-08-14
签名算法与服务端实现对齐
  • 修复服务端签名校验 bug:stringToSign 第二行由 AppKey 误用改为 AppSecret,与本文档签名算法完全一致
  • 现按本文档「签名算法」章节实现的应用端请求均可正常通过签名验证(X-App-Id + AppSecret + X-Timestamp + X-Nonce + RequestBody)
2026-08-14
AppKey/AppSecret 格式规范化
  • 新建/重置应用密钥时,AppKey 统一生成格式 ak_+29位随机(总长32),AppSecret 统一生成格式 sk_+61位随机(总长64)
  • 存量应用的 AppKey/AppSecret 保持不变,如需新格式可在应用管理中重置密钥
2026-08-13
付费会员新增首次购买优惠价格
  • 等级配置新增 first_price 字段(首次购买优惠价格,元;0=无首购优惠),随 /api/v1/levels 与 /levels/:code 返回
2026-08-13
会员等级类型与时长调整
  • 会员类型由「月卡/年卡/永久」改为「免费会员(free)/付费会员(paid)」
  • 时长由按月改为按天,字段 duration_months 变更为 duration_days;免费会员 duration_days=0 表示不限制时长
  • 付费会员到期后自动降级为免费会员;未到期续费时在原有到期时间上累加时长
2026-08-13
新增注册验证码接口
  • POST /api/v1/auth/register/send-code 发送注册验证码(固定场景码 sms_register,手机号须未被注册,验证码5分钟有效)
  • POST /api/v1/auth/register 传 phone 时须再传 code 校验注册验证码(验证码使用后立即失效);不传 phone 则保持纯用户名/密码注册兼容
2026-08-13
应用端短信改为业务场景码调用
  • /api/v1/sms/send 由 template_code 改为 scenario(业务场景码)+ params,按场景码匹配应用配置模板
  • /member/send-bind-code、/auth/forgot-password/send-code 不再传 template_code,分别固定使用场景码 sms_bind_phone、sms_forgot_password
  • 管理端「编辑应用-短信配置」模板新增「业务场景码」字段;更换模板只需改配置,应用端零改动
2026-08-13
新增找回/重置密码接口
  • POST /api/v1/auth/forgot-password/send-code 发送找回密码验证码(手机号+应用短信模板,验证码5分钟有效)
  • POST /api/v1/auth/reset-password 重置密码(校验短信验证码,验证码使用后立即失效,并清除登录失败锁定记录)
2026-08-13
接口审计与一致性修复
  • GET /api/v1/member/info 增加 level_code(会员当前等级编码,app_members.level_code)
  • GET /api/v1/member/linked-apps 增加 level_code(各应用账号等级编码)
  • GET /api/v1/levels 与 /levels/:code 默认等级(含 free)统一返回 level_config 字段结构(code/name/type/points/price/duration_months/permissions/status),纠正等级接口字段不一致
2026-08-13
订单来源字段
  • 订单增加 source 字段:app=应用端订单,admin_test=管理端测试订单
  • 管理端订单列表 GET /api/admin/orders 支持不传 status 时返回全部状态订单(修复默认只显示待支付)
  • 管理端订单列表/详情返回 source 与 app_name(所属应用名称),详情含应用会员/全局会员信息
  • 应用端订单查询 GET /api/v1/payment/order/:order_no 响应增加 source 字段
2026-08-13
会员等级与功能权限架构统一
  • 等级/权限数据源统一为应用级配置(apps.level_config / apps.permission_config)
  • GET /api/v1/levels、/levels/:code 返回应用的 level_config(字段 code/name/type/points/price/duration_months/permissions/status)
  • GET /api/v1/permissions/check 所需等级由 level_config 中各等级的 permissions 字段决定
  • 积分兑换按等级 code 进行(app_members.level_code)
2026-08-13
接口文档深度更新
  • 新增:健康检查 GET /health
  • 新增:会员绑定手机号(发送绑定验证码/绑定)
  • 新增:支付下单/订单查询真实参数与响应
  • 新增:订单查询响应增加 source 来源字段(app=应用端;管理端测试订单 source=admin_test)
  • 新增:积分变动/兑换/兑换选项接口
  • 新增:等级权限检查 GET /api/v1/permissions/check
  • 修正:移除已不存在的旧接口(找回/重置密码、订单列表等)
  • 优化:请求与响应示例与真实 handler 返回保持一致
2026-08-12
管理端优化
  • 新增:登录页滑动拼图验证码
  • 新增:账号中心(密码修改/手机号修改)
  • 新增:应用列表搜索/排序/AppKey复制
  • 修复:应用编辑弹窗Tab切换功能
  • 优化:应用编辑弹窗Tab内容改为表单表格方式
  • 新增:应用列表Secret列(脱敏显示)
  • 新增:新增应用成功弹窗及凭证下载
  • 优化:操作按钮改为图标按钮
  • 优化:接口文档页面改版
  • 新增:登录页增加接口文档链接(游客可查看)
  • 优化:新增/编辑应用从弹窗改为右侧边栏面板
  • 优化:AppKey和Secret合并为一列
  • 新增:AK/SK Tab(AppKey/Secret/重置按钮)
  • 优化:编辑应用改为新标签页打开

接口状态监控

总接口数
-
正常
-
异常
-
待检查
-
上次检查:-
接口列表(完整表格视图)
分组 接口名称 方法 接口地址 状态
加载中...
分组详情(卡片视图)