作用域 · /api/content
获取公开或可编辑内容列表
view 缺省时返回已发布内容;view=editable 时返回当前 Staff 可管理的列表展示投影,并要求提供 scope。该投影包含草稿状态, 以及对应列表布局需要的摘要、封面和媒体信息;动态额外包含正文。
GET
/api/content访问限制
公开作者管理员
无需登录即可调用。
view=editable 需要 author 或 admin;author 只能读取自己的内容。
请求参数
Path、query 与需要手动提供的 header 参数会在这里统一列出。
vieweditablequery缺省为公开视图;editable 明确请求 Staff 编辑视图。
默认值 omitted
scopepost | article | showpiecequery缺省时返回三类内容的混合流。
默认值 omitted
cursorstringqueryOpaque cursor returned by the previous page.
默认值 omitted
limitintegerquery-
默认值 20
qstringquery-
默认值 omitted
authorstringquery-
默认值 omitted
categorystringquery-
默认值 omitted
tagstringquery-
默认值 omitted
fromstring:date-timequery-
默认值 omitted
tostring:date-timequery-
默认值 omitted
sortpublished_desc | published_ascquery-
默认值 published_desc
响应结构
响应 schema 按状态码切换查看;错误响应统一复用标准错误结构。
200
application/json已发布内容列表。
oneOf(object | object)
选项 1: object
选项 2: object