加载中…
单页内容 page

模块说明

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 已按当前语言提取。
添加日期:2026-10-06