Skip to content

内容与门户接口 ​

内容管理 ​

文章与分类提供完整 REST CRUD:

  • /api/v1/content/articles
  • /api/v1/content/articles/{id}
  • /api/v1/content/categories
  • /api/v1/content/categories/{id}

文章列表支持 page、pageSize、keyword、categoryId 和 status。内容字段为字符串数组,便于不同 UI 编辑器以段落形式呈现。

门户公开数据 ​

/api/v1/public/** 无需登录:

路径用途
/blog、/blog/{id}博客分页与详情
/home首页统计、高亮与评价
/features、/product产品能力
/pricing套餐方案
/faq、/docs帮助内容
/about团队与里程碑
/contact联系表单提交(POST)

博客评论读取 GET /api/v1/public/blog/{id}/comments 也允许匿名访问。

需要登录的站点交互 ​

方法与路径用途
POST /api/v1/blog/{id}/comments以当前登录用户身份发表评论
POST /api/v1/payments/checkout为付费套餐创建待支付订单

匿名写入返回 HTTP 401。支付接口接收 planId 与 channel(alipay、wechat 或 card),返回订单号、金额、过期时间与演示支付地址。评论和订单由 V7__site_interactions.sql 创建的数据表持久化。

公开只代表无需身份,不代表允许任意写入。价格页和博客页本身保持公开,只有点击购买或提交评论时才跳转登录,登录后按 redirect 参数返回原页面。

Released under the MIT License.