HuanCode Docs

微信公众号草稿箱 API:新增草稿 (draft/add)

微信公众号 draft/add 接口的参数、调用方式与返回值说明,覆盖订阅号与服务号。

新增草稿 (draft/add)

来源:微信公众号文档 - 新增草稿

接口说明

  • 英文名称: draft_add
  • 功能: 新增草稿到草稿箱。草稿箱中的素材被群发或发布后,该素材将从草稿箱中移除。草稿箱中的素材也可在公众平台官网素材管理中看到。

适用范围

账号类型是否支持
订阅号
服务号

注意:接口必须从服务端调用,不可从客户端(小程序、网页、App 等)调用。

调用方式

HTTPS 调用

POST https://api.weixin.qq.com/cgi-bin/draft/add?access_token=ACCESS_TOKEN
  • 云调用: 不支持
  • 第三方调用: 支持(权限集:11, 100)

请求参数

Query 参数

参数类型必填说明
access_tokenstring接口调用凭证

Body 参数

请求体为 JSON 格式,包含 articles 数组,每个元素为一篇文章:

参数类型必填说明
article_typestring文章类型:"news"(图文,默认)或 "newspic"(图片消息)
titlestring标题,最多 32 个字符
authorstring作者,最多 16 个字符
digeststring摘要,最多 128 个字符
contentstring正文内容(最大 2KB,不超过 2 万字符,不超过 1MB)
content_source_urlstring原文链接 URL,最多 1KB
thumb_media_idstring封面图的 media_id(图文类型时必填)
need_open_commentnumber是否开启评论:0 关闭(默认),1 开启
only_fans_can_commentnumber是否仅粉丝可评论:0 所有人(默认),1 仅粉丝
pic_crop_235_1string封面图 2.35:1 裁剪坐标
pic_crop_1_1string封面图 1:1 裁剪坐标
image_infoobject是(图片消息)图片列表信息(最多 20 张图片,仅 article_type"newspic" 时必填)
cover_infoobject封面信息(含裁剪详情)
product_infoobject商品信息

返回参数

参数类型说明
media_idstring上传后的素材标识(最大 128 个字符)

请求示例

{
  "articles": [
    {
      "article_type": "news",
      "title": "TITLE",
      "author": "麦多多",
      "digest": "DIGEST",
      "content": "CONTENT",
      "thumb_media_id": "R7Ifp6ogGOmtr3u-l6KIJfD6AX2foQ7Ktp4flZtYJbtO2H-Tmfg4xO0sl9mh9ByJ"
    }
  ]
}

返回示例

{
  "media_id": "MEDIA_ID"
}

错误码

错误码说明解决方案
53404账号受限(电商相关)删除商品后重试
53405商品信息无效检查参数和商品状态
53406电商能力未开通先开通电商能力

On this page