工作流定价与购买
工作流支持 free(免费)、metered(按量计费标识,模板下载免费)和 buyout(永久买断,含全部历史版本及后续更新)。三种方式下载 ZIP 均需登录;年度会员不自动包含买断权益。
具备发布权限的账号可用中央 API Key 修改自己固定归属的工作流;管理员后台可修改全部工作流。发布接口不接收定价字段,首次发布默认免费,后续版本保留原定价。
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /api/workflows/{slug}/pricing |
Bearer API Key 查询本人工作流定价 |
| PUT | /api/workflows/{slug}/pricing |
JSON {revision,pricingMode,priceFen} 修改定价 |
| GET | /api/me/workflows/{slug}/access |
本人权益与可见的工作流信息 |
| POST | /api/me/workflows/{slug}/purchase |
JSON {requestKey: UUID, revision} 创建或恢复买断订单 |
| GET | /api/me/workflows/orders/{orderNo} |
本人订单,核验支付及退款状态 |
| GET | /api/me/workflows/orders |
本人购买记录 |
| GET | /api/me/workflows/downloads |
本人下载记录 |
| GET | /api/admin/workflows/records/orders |
管理员查询购买记录 |
| GET | /api/admin/workflows/records/downloads |
管理员查询下载记录 |
定价返回 {slug,revision,pricingMode,priceFen}。priceFen 为人民币整数分,上限 100000000;买断必须大于零,免费和按量必须为零。使用 GET 返回的 revision,冲突返回 409。改价记录审计,不影响历史订单金额或已有权益,发布新版本不覆盖定价。
权益、购买、个人订单及后台记录接口仅接受网页登录,显式携带 Authorization 会被拒绝;购买 POST 校验 Origin。权益返回 {owned,canDownload,workflow},仅对当前登录用户有效;下架模板只允许有效买断用户读取。
创建购买返回 {order},包含 orderNo、checkoutUrl、amount(人民币元,与 priceFen 单位不同);完整保留收银台 URL 的 fragment,超时先查询原单,不重复付款。
同一次购买生成并保留一个 UUID requestKey,使用读到的 revision;超时后按原 requestKey 恢复,不能生成新 Key 重复下单。同一用户同一模板的待付款订单会复用;Key 被用于其它模板、定价已变化或已购买等冲突返回 409。
只有中心核验付款后订单才变为 active 并获得永久权益;全额成功退款撤销原单权益,部分退款只记录金额。
记录返回 {items,total,page,pageSize},支持 page、pageSize(默认 20,最多 50)、slug、from/to(带时区 ISO 时间)。管理员另可按 userId 筛选,购买记录支持 status:pending、active、expired、refunded。个人接口强制本人范围。页面入口为 /account/workflows 和 /admin/workflows/records。
支付结果与订单状态
购买跳转灵途造物统一收银台,返回 /account/payments/result。收银台链接的 fragment 含访问凭证,应完整保留,不写入日志。支付返回页、浏览器跳转或截图不构成付款凭据;服务端查询本人订单并核验中央支付及退款状态后交付权益。
| 状态 | 含义 |
|---|---|
pending |
待付款或结果待确认,继续查询原单 |
active |
付款已核验,具有买断下载权益 |
expired |
订单已过期 |
refunded |
全额成功退款,原单权益已撤销 |
买断用户在模板下架后仍可查看与下载;已有购买订单的模板禁止永久删除。已删除或正在清理的模板不可下载。