博客 API 文档

带 status=0 调用 POST /api/v1/blog/posts/save，创建一个已经包含后台编辑器全部 SEO 字段的草稿。

{
  "language": "zh",
  "title": "账号基础设施如何支持增长团队",
  "summary": "说明团队如何用可运营账号支撑市场启动、区域访问、社媒运营和客服支持流程。",
  "slug": "account-infrastructure-growth-workflows-zh",
  "alternateSlug": "account-infrastructure-growth-workflows",
  "contentHtml": "<h1>账号基础设施如何支持增长团队</h1><p>第一段直接说明业务问题和适用场景。</p><h2>先验证区域访问</h2><p>补充具体流程、证据和站内链接。</p><figure><img src=\"https://media.cbgaccount.com/file/blog-assets/account-infrastructure-growth-workflows-zh.webp\" alt=\"用于市场启动和区域访问的账号基础设施流程图\" width=\"1200\" height=\"675\" /></figure><h2>常见问题</h2>",
  "coverImage": "https://media.cbgaccount.com/file/blog-assets/account-infrastructure-growth-workflows-zh.webp",
  "coverAlt": "用于市场启动和区域访问的账号基础设施流程图",
  "categoryId": 1,
  "tagIds": [
    1,
    2
  ],
  "authorId": 1,
  "seoTitle": "账号基础设施如何支持增长团队 | CBGAccount",
  "seoDescription": "了解账号基础设施如何支持市场启动、区域访问、社媒运营和更稳定的客服支持流程。",
  "canonicalUrl": "",
  "robots": "index,follow",
  "indexable": true,
  "ogTitle": "账号基础设施如何支持增长团队",
  "ogDescription": "给市场、区域、创作者和客服账号工作流使用的实操指南。",
  "ogImage": "https://media.cbgaccount.com/file/blog-assets/account-infrastructure-growth-workflows-zh.webp",
  "answerSummary": "账号基础设施帮助团队在扩张账号业务前先验证访问、归属、支持路径和流程证据。",
  "keyTakeaways": [
    "上线前先梳理归属和恢复路径",
    "让内链和证据在正文中可见",
    "运营规则变化后及时复审高价值文章"
  ],
  "faqBlocks": [
    {
      "question": "团队什么时候应该准备账号基础设施？",
      "answer": "当团队要启动新市场、创作者流程、客服队列或依赖可重复账号访问的业务流程前，就应该先准备。"
    }
  ],
  "relatedProductIds": "12,18",
  "reviewedAt": "2026-05-25 12:00:00",
  "status": 0
}

POST /api/v1/blog/posts/check 不保存数据。用返回建议补全 slug、meta、摘要、OG 和目录后再保存。

{
  "code": "0000",
  "message": "success",
  "data": {
    "score": 92,
    "aeoScore": 88,
    "canPublish": true,
    "scoreSummary": "确认 canonical 和最终图片 alt 后即可发布。",
    "generatedSlug": "account-infrastructure-growth-workflows-zh",
    "generatedSeoTitle": "账号基础设施如何支持增长团队 | CBGAccount",
    "generatedSeoDescription": "了解账号基础设施如何支持市场启动、区域访问、创作者运营和客服流程。",
    "generatedOgTitle": "账号基础设施如何支持增长团队",
    "generatedExcerpt": "给账号业务增长团队使用的实操运营指南。",
    "toc": [
      {
        "id": "先验证区域访问",
        "title": "先验证区域访问",
        "level": 2
      },
      {
        "id": "常见问题",
        "title": "常见问题",
        "level": 2
      }
    ],
    "items": [
      {
        "key": "title-length",
        "passed": true,
        "severity": "info",
        "message": "SEO 标题长度合适。"
      },
      {
        "key": "internal-links",
        "passed": true,
        "severity": "info",
        "message": "正文包含站内链接。"
      }
    ]
  }
}

POST /api/v1/blog/posts/{id}/publish 会重新运行 SEO 检查，只有阻塞项通过才会正式发布。

{
  "code": "0000",
  "message": "success",
  "data": {
    "id": 42,
    "slug": "account-infrastructure-growth-workflows-zh",
    "title": "账号基础设施如何支持增长团队",
    "status": 1,
    "publishedAt": "2026-05-25 12:30:00",
    "canonicalUrl": "https://www.cbgaccount.com/zh/blog/account-infrastructure-growth-workflows-zh",
    "robots": "index,follow",
    "seoScore": 92,
    "sitemapUpdated": true,
    "rssUpdated": true,
    "webhookQueued": true
  }
}

code 不是 0000 时不要继续发布。把 message 和 failedItems 展示给运营人员，让他们修文章。

{
  "code": "BLOG_SEO_BLOCKED",
  "message": "草稿无法发布，因为存在阻塞级 SEO 检查项。",
  "data": {
    "canPublish": false,
    "failedItems": [
      "missing-cover-alt",
      "thin-content",
      "duplicate-slug"
    ]
  }
}