订单与平台运营
这些接口当前依赖网页会话和业务角色校验，尚未提供通用 Bearer 接入。以下为可扩展能力清单，程序接入前需补充后端鉴权与公开契约。
| 方法 | 现有路径 | 能力 |
|---|---|---|
| POST / GET | /api/orders / /api/orders/{orderNo} |
创建、查询课程订单 |
| POST / GET | /api/series/orders / /api/series/orders/{orderNo} |
创建、查询系列订单 |
| POST | /api/gifts/claim |
领取赠课权益 |
| GET | /api/company/members |
公司成员列表 |
| POST | /api/company/access、/api/company/invitations、/api/company/invitations/claim |
公司访问检查、邀请、接受邀请 |
| DELETE | /api/company/members/{id} |
移除成员 |
| GET | /api/promotions、/api/promotions/export |
成员推广统计、CSV 导出 |
| GET / POST | /api/promotions/link |
查询、生成推广链接 |
| PATCH | /api/promotions/status |
调整推广状态 |
| GET | /api/admin/skill-publishers |
已授权发布账号列表 {members:[{userId,name}]}，管理员限定 |
| POST | /api/admin/skill-publishers/members |
账号发布权限，JSON {userId,enabled}，管理员限定；写入校验 Origin |
| GET | /api/admin/skillhub |
后台技能目录 |
| GET / PUT / DELETE | /api/admin/skillhub/{slug} |
目录详情、编辑、永久删除；中央 API Key 不可调用 |
| GET / PATCH / DELETE | /api/admin/users |
查询、更新用户及账号管理，管理员限定 |
| GET / POST | /api/admin/learning-entitlements |
查询、调整学习权益，管理员限定 |
| GET / PATCH | /api/admin/series |
查询、设置课程系列，管理员限定 |
| GET / PATCH / POST | /api/admin/benefits |
系列商品配置，管理员限定 |
| POST | /api/admin/benefits/sync |
同步中央商品，管理员限定 |
| PATCH | /api/admin/courses/{id}/catalog |
课程上架配置，管理员限定 |
| POST | /api/admin/courses/reorder |
课程目录排序，管理员限定 |
统一商品与支付
课程与系列使用中央商品版本和报价，通过灵途造物统一收银台支付；学堂维护内容交付范围和学习权限。订单创建响应中的 checkoutUrl 需要完整跳转，amount 为人民币元，不从页面缓存价格自行计算应付金额。支付结果返回 /account/payments/result，由服务器核验原单后发放权益。
系列、整课、单集和赠课按各自购买契约处理；免费订阅不创建支付单。全额成功退款撤销该订单交付的权益，部分退款记录金额，不按比例自动缩短学习期限。统一支付回调为 /api/payments/notify，旧微信直连支付通知及支付 OAuth 入口已撤下。创建订单超时后查询原单并复用原请求标识，不以更换请求标识解决未知付款结果。
技能后台采用紧凑列表与详情弹窗，不展示或编辑获取方式、行业、发布来源；行业和获取方式保留接口兼容用途，发布来源字段已移除。删除前先下架并保存，DELETE 携带 version,updatedAt，同时清理全部发布版本的 TOS 文件及对象历史版本、删除标记；失败保留待清理状态，可重试。平台入口 Skill 不支持删除。
上述平台管理接口需另立管理员授权范围后再接入。统一支付回调 /api/payments/notify、微信回调、统一登录回调、访问埋点与分享归因不作为用户 CLI 业务命令。旧密钥创建与撤销接口 /api/me/skill-publisher-keys 已停用并返回 410；密钥创建、撤销、有效期和应用授权统一在灵途造物网页完成。学堂 GET /api/me/api-keys?page=1 只返回本人已授权学堂的密钥元信息，该接口还返回 publishAllowed，要求学堂网页登录，不接受 API Key 调用。POST /api/me/api-keys/scopes 已停用并返回 410，发布权限由管理员按账号统一设置。GET /api/auth/me 当前查询的是学堂网页会话，不是 CLI Key 验证接口；注册、密码、手机号与账号注销等账户管理走账号中心，不另做学堂 CLI 账号命令。
学员投稿创建、编辑、上传、提交和撤回，以及 /api/admin/skill-submissions 和 /api/admin/skillhub/{slug}/moderation 已停用，后端退役处理返回 410；不再作为可用接入能力。GET /api/me/skills 保留历史作品读取和账号发布权限查询，不能据此推断仍支持投稿。
旧 /api/membership、/api/admin/course-rights、灵途旧登录/绑定及 /api/company/members/sync 已退役；不要据旧接口盘点新增命令。/api/membership/orders 仅为兼容路径，新能力使用明确系列订单。/api/v1/pages 不属于当前学堂 API 路由实现，不能按旧展示文案当作可用接口。
