跳到主要内容

getTagBlogs

按博客标签 key 取该标签下已上架的文章卡列表。运营在 ERP「博客标签」里建一个标签（如 index-blog）并给文章打标，前台只传这个 key 就能拿到文章，换文章不需要发版。

典型用法：首页「Stories & Guides / From the Journal」等编辑推荐位。

:::tip 与 getBlog 的区别 过去要挑几篇文章放某个位置，只能拉 getBlog（全语言聚合，含 content 正文与关联文章/商品）再在前端拍平筛选。本接口把筛选下推到 SQL（走标签关联表子查询），且显式排除 content 正文——文章正文常上万字符，标签位只要卡片信息，响应量级差一到两个数量级。 :::

属性值
方法GET
路径/config/getTagBlogs
鉴权公开

请求参数​

参数类型必填默认说明
tagKeystring是—标签 key，即后台创建标签时填的那个（如 index-blog）
languagestring否en语言码。该语言下没有此标签时整体回退 en（标签元信息与文章同批回退，不会出现「英文标签名 + 日文文章」）
limitnumber否不限只回前 N 条。<=0 或非数字视为不限

响应​

{
  "code": 0,
  "message": "",
  "data": {
    "tag": {
      "key": "index-blog",
      "name": "Index Blog",
      "description": "",
      "language": "en"
    },
    "blogList": [
      {
        "key": "lab-grown-vs-natural-diamonds",
        "sort_key": "diamond-education",
        "sort_name": "Diamond Education",
        "title": "Lab-Grown vs Natural Diamonds: What Actually Changes",
        "image": "https://asset.boldradiant.com/public/blog/lab-grown-vs-natural-diamonds/cover.jpg",
        "weight": 80,
        "updated_time": "2026-09-07T11:22:33Z",
        "created_time": "2026-09-07T11:22:33Z"
      }
    ]
  }
}

data.tag​

标签元信息，取自标签字典表 erp_blog_tag。

字段类型说明
keystring标签 key
namestring标签展示名；后台未填时回落为 key
descriptionstring标签描述，可空串
languagestring实际命中的语言。请求 language=ja 但只有 en 标签时，这里回 en

:::note 没有 image / scene_image 和 getTagProducts 的 tag 不同，博客标签没有配图字段——博客标签不做 /blog/tag/<key> 落地页，无需 hero 图，故标签字典表本身就没有这两列。 :::

data.blogList​

文章卡数组，按 weight 降序、同权重按 updated_time 新的在前。

字段类型说明
keystring文章 key
sort_keystring所属分类 key（拼详情页链接 /blog/{sort_key}/{key} 用）
sort_namestring所属分类展示名，供卡片眉标（如 Diamond Education）
titlestring文章标题
imagestring封面图 URL，可空串（前台自行走占位）
weightnumber排序权重，降序
updated_timestring更新时间（RFC3339），与 getBlog 里文章的同字段同形
created_timestring创建时间（RFC3339）

:::warning 不含正文 响应里没有 content 字段。标签位只渲染封面 + 眉标 + 标题 + 日期；正文在详情页由 getBlogDetail 单篇取。 :::

两种「空」的区分​

情况响应前台建议
标签不存在（回退 en 后仍不存在）data 为 null该模块整块隐藏
标签存在，但下面没有已上架文章data.tag 有值，data.blogList 为 []同样隐藏该模块（或显示空态）

过滤规则​

  • 只回 enabled = 1 的文章；
  • 文章所属分类不存在或已停用时该文章不露出——博客卡片眉标依赖分类名，且分类页是 /blog/{sort_key}，分类停用时链接会 404；
  • 排序沿用 weight 降序，前台不应再按时间重排：weight 是运营在后台设的排序意图，重排会导致后台调权重看不到效果；
  • 缺 tagKey 或查询失败返回 code: 10105。

示例​

# 首页 Stories & Guides 位：取前 3 篇
curl -s 'https://service.boldsaasify.com/config/getTagBlogs?tagKey=index-blog&language=en&limit=3' \
  -H 'X-Site-Domain: boldradiant.com'

# 取该标签全部文章
curl -s 'https://service.boldsaasify.com/config/getTagBlogs?tagKey=index-blog' \
  -H 'X-Site-Domain: boldradiant.com'