Skip to content

配置接口

获取评论相关的公开配置,用于前端组件读取博主邮箱、徽标等信息。

获取配置

GET /api/config/comments

获取评论相关的公开配置,用于前端组件读取博主邮箱、徽标等信息。

  • 方法:GET
  • 路径:/api/config/comments
  • 鉴权:不需要

查询参数

名称位置类型必填说明
siteIdquerystring站点 ID,用于多站点数据隔离,默认 default

成功响应

  • 状态码:200
json
{
  "adminEmail": "admin@example.com",
  "adminBadge": "博主",
  "avatar": "https://gravatar.com/avatar",
  "adminEnabled": true,
  "allowedDomains": [],
  "requireReview": false,
  "enableCommentLike": true,
  "enableArticleLike": true,
  "enableImageLightbox": true,
  "commentPlaceholder": "发表你的看法...",
  "adminLanguage": "zh-CN",
  "widgetLanguage": "auto"
}

字段说明:

字段名类型说明
adminEmailstring博主邮箱地址,用于在前端展示"博主"标识,并触发管理员身份验证流程
adminBadgestring博主标识文字,例如 "博主"
avatarPrefixstring头像地址前缀,如 Gravatar 或 Cravatar 需像地址
adminEnabledboolean是否启用博主标识相关展示(关闭时不显示徽标,但仍可作为管理员邮箱)
allowedDomainsArray<string>允许调用组件的域名列表,留空则不限制
requireReviewboolean是否开启新评论先审核再显示(true 表示新评论默认为待审核)
enableCommentLikeboolean是否启用评论点赞功能(默认 true)
enableArticleLikeboolean是否启用文章点赞功能(默认 true)
enableImageLightboxboolean是否启用评论图片灯箱预览功能(默认 false)
commentPlaceholderstring | null评论输入框的占位符文本,留空则使用默认值
adminLanguagestring | null管理后台界面语言代码,如 zh-CNen-US,仅供后台使用
widgetLanguagestring | null评论前端组件默认语言代码,支持 auto 自动根据浏览器语言选择

错误响应

  • 状态!码:500
json
{
  "message": "加载评论配置失败"
}

基于 Cloudflare Workers 构建