如何用Wix API及访问令牌创建博客草稿？内容未生成问题排查

问题原因 #

你提交的请求体中，richContent.nodes的格式不符合Wix Blog API的规范：

• 第一个段落节点直接使用了text字段，而Wix API要求段落文本必须嵌套在textData.text中；
• 即使部分节点使用了textData，只要存在不符合规范的节点，整体内容可能被API忽略。

修正后的请求示例 #

以下是完全符合API规范的请求体，可正常生成博客内容：

{
  "draftPost": {
    "title": "abc1",
    "richContent": {
      "nodes": [
        {
          "type": "paragraph",
          "textData": {
            "text": "This is a paragraph of text."
          }
        },
        {
          "type": "paragraph",
          "textData": {
            "text": "This is a paragraph of text."
          }
        },
        {
          "type": "paragraph",
          "style": {
            "paddingTop": "20px"
          },
          "textData": {
            "text": "This is a paragraph of text with top padding."
          }
        }
      ]
    },
    // 可选：添加分类、标签等额外信息
    "categories": [{"id": "your-category-id"}],
    "tags": ["tech", "tutorial"]
  },
  "publish": false
}

使用Wix API创建博客文章的详细方法 #

1. 准备API权限 #

• 登录Wix开发者后台，创建新应用；
• 为应用分配Blog > Write权限，生成API访问令牌（Bearer Token）；
• 确保令牌包含操作博客文章所需的全部权限范围。

2. 确定API端点 #

• 创建草稿：POST https://www.wixapis.com/blog/v3/draft-posts
• 直接发布文章：POST https://www.wixapis.com/blog/v3/posts

3. 构造请求体核心字段说明 #

• draftPost.title：博客标题（必填）；
• draftPost.richContent：富文本内容，由多个nodes组成，支持多种类型：
  • 段落节点：type: "paragraph"，文本放在textData.text，可通过style设置内边距、字体等样式；
  • 标题节点：type: "heading"，需指定level（1-6），文本放在textData.text；
  • 图片节点：type: "image"，需传入src（图片URL）和altText（替代文本）；
• publish：布尔值，仅草稿端点支持，true表示直接发布，false表示保存为草稿；
• 可选字段：categories（关联分类ID数组）、tags（标签数组）、featured（是否设为精选）等。

4. 发送请求示例（curl） #

curl -X POST \
  https://www.wixapis.com/blog/v3/draft-posts \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "draftPost": {
      "title": "My First Wix Blog Post",
      "richContent": {
        "nodes": [
          {
            "type": "heading",
            "level": 1,
            "textData": {
              "text": "Welcome to My Blog"
            }
          },
          {
            "type": "paragraph",
            "textData": {
              "text": "This is my first blog post created via Wix API."
            }
          },
          {
            "type": "image",
            "src": "https://example.com/image.jpg",
            "altText": "Sample Image"
          }
        ]
      },
      "tags": ["API", "Wix"]
    },
    "publish": false
  }'

5. 处理响应 #

成功请求后，API会返回创建的草稿/文章对象，包含id、title、richContent等字段，可通过返回值确认内容是否正确生成。

内容的提问来源于stack exchange，提问作者user21560133