学习、学员与统计
这些接口当前依赖网页会话和业务角色校验,尚未提供通用 Bearer 接入。以下为可扩展能力清单,程序接入前需补充后端鉴权与公开契约。
| 方法 | 现有路径 | 能力 |
|---|---|---|
| GET | /internal/learning/subscriptions |
本人订阅 |
| GET | /internal/learning/courses/{id}/access、purchase-state、draft-access |
课程权益、购买状态、草稿访问判断;后两项是同级路径后缀 |
| GET | /internal/learning/courses/{id}/contents/{contentId}/view-mode |
内容阅读模式判断 |
| GET / POST | /api/contents/{slug}/comments |
读取、发表评论 |
| GET | /api/courses/{id}/comments |
课程评论 |
| DELETE | /api/courses/{id}/comments/{commentId} |
删除评论 |
| GET / POST / DELETE | /api/contents/{slug}/reactions/{kind} |
查询、添加、取消互动 |
| GET | /api/courses/{id}/share-ref、/api/courses/{id}/share-stats |
分享引用、课程分享统计 |
| GET | /api/courses/{id}/contents/{contentId}/share-stats |
内容分享统计 |
| GET / POST | /api/courses/{id}/learners |
学员列表、授予权益 |
| DELETE | /api/courses/{id}/learners/{entitlementId} |
撤销学员权益 |
| POST | /internal/creator/courses/{id}/sales |
课程销售统计 |
| POST | /internal/creator/performance-review |
经营统计 |
学习判断接口不返回正文。课程与内容页面的 SSR 数据、内部创作读写和统计接口应单独设计最小公开契约,不能整体暴露 /internal/* 或直接将后台内容接口当作学员全文下载接口。