订单与平台运营
这些接口当前依赖网页会话和业务角色校验，尚未提供通用 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 / POST | /api/admin/skill-publishers |
发布来源管理，管理员限定 |
| POST | /api/admin/skill-publishers/members |
发布来源成员授权，管理员限定 |
| GET | /api/admin/skillhub |
后台技能目录 |
| GET / PUT / DELETE | /api/admin/skillhub/{slug} |
目录详情、编辑、永久删除；中央 API Key 不可调用 |
| GET | /api/admin/skill-submissions、/api/admin/skill-submissions/{id}、/api/admin/skill-submissions/{id}/download |
审核队列、快照、审核包 |
| POST | /api/admin/skill-submissions/{id}、/api/admin/skillhub/{slug}/moderation |
审核、精选、强制上下架 |
| 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 |
课程目录排序，管理员限定 |
上述平台管理接口需另立管理员授权范围后再接入。统一支付回调 /api/payments/notify、微信回调、OAuth 回调、访问埋点与分享归因不作为用户 CLI 业务命令。旧密钥创建与撤销接口 /api/me/skill-publisher-keys 已停用并返回 410；密钥创建、撤销、有效期和应用授权统一在灵途造物网页完成。学堂 GET /api/me/api-keys?page=1 只返回本人已授权学堂的密钥元信息，POST /api/me/api-keys/scopes 保存 {keyId,publishers} 来源范围；两者均要求学堂网页登录，写入检查 Origin，不接受 API Key 调用。GET /api/auth/me 当前查询的是学堂网页会话，不是 CLI Key 验证接口；注册、密码、手机号与账号注销等账户管理走账号中心，不另做学堂 CLI 账号命令。
旧 /api/membership、/api/admin/course-rights、灵途旧登录/绑定及 /api/company/members/sync 已退役；不要据旧接口盘点新增命令。/api/membership/orders 仅为兼容路径，新能力使用明确系列订单。/api/v1/pages 不属于当前学堂 API 路由实现，不能按旧展示文案当作可用接口。
