模块说明
page 读取后台维护的单页内容(关于我们、服务条款、隐私政策等),正文已由服务端把 Markdown 渲染为 HTML 片段,同时累计阅读量。
鉴权级别:可选(匿名可调)。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/page |
可选 | 读取单页内容 |
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
id |
二选一 | 单页 ID |
slug |
二选一 | 单页英文标识(后台维护) |
GET /api/page?id=1
GET /api/page?slug=about
id 与 slug 至少提供一个;ID 解析失败或无匹配数据时返回 422(message 提示页面参数错误)。
响应
{
"code": "OK",
"message": "",
"data": {
"title": "关于我们",
"page": {
"id": 1,
"name": "关于我们",
"content": "<p>……(已渲染 HTML)</p>",
"keywords": "...",
"description": "...",
"click": 128
}
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
| 字段 | 说明 |
|---|---|
title |
页面标题(等于单页名称) |
page.content |
已渲染的 HTML,可直接注入页面容器展示 |
page.click |
阅读量(本次读取后的最新值) |
注意事项
content是 HTML 片段而非 Markdown 原文,客户端直接渲染即可,不要再做 Markdown 解析;- 每次成功读取会递增
click阅读量,调试/爬取时注意避免无意义的频繁请求; - 多语言站点下
name/content/keywords/description已按当前语言提取。