微信公众号草稿箱 API:新增草稿 (draft/add)
微信公众号 draft/add 接口的参数、调用方式与返回值说明,覆盖订阅号与服务号。
来源:微信公众号文档 - 新增草稿
- 英文名称: draft_add
- 功能: 新增草稿到草稿箱。草稿箱中的素材被群发或发布后,该素材将从草稿箱中移除。草稿箱中的素材也可在公众平台官网素材管理中看到。
注意:接口必须从服务端调用,不可从客户端(小程序、网页、App 等)调用。
POST https://api.weixin.qq.com/cgi-bin/draft/add?access_token=ACCESS_TOKEN
- 云调用: 不支持
- 第三方调用: 支持(权限集:11, 100)
| 参数 | 类型 | 必填 | 说明 |
|---|
| access_token | string | 是 | 接口调用凭证 |
请求体为 JSON 格式,包含 articles 数组,每个元素为一篇文章:
| 参数 | 类型 | 必填 | 说明 |
|---|
| article_type | string | 否 | 文章类型:"news"(图文,默认)或 "newspic"(图片消息) |
| title | string | 是 | 标题,最多 32 个字符 |
| author | string | 否 | 作者,最多 16 个字符 |
| digest | string | 否 | 摘要,最多 128 个字符 |
| content | string | 是 | 正文内容(最大 2KB,不超过 2 万字符,不超过 1MB) |
| content_source_url | string | 否 | 原文链接 URL,最多 1KB |
| thumb_media_id | string | 否 | 封面图的 media_id(图文类型时必填) |
| need_open_comment | number | 否 | 是否开启评论:0 关闭(默认),1 开启 |
| only_fans_can_comment | number | 否 | 是否仅粉丝可评论:0 所有人(默认),1 仅粉丝 |
| pic_crop_235_1 | string | 否 | 封面图 2.35:1 裁剪坐标 |
| pic_crop_1_1 | string | 否 | 封面图 1:1 裁剪坐标 |
| image_info | object | 是(图片消息) | 图片列表信息(最多 20 张图片,仅 article_type 为 "newspic" 时必填) |
| cover_info | object | 否 | 封面信息(含裁剪详情) |
| product_info | object | 否 | 商品信息 |
| 参数 | 类型 | 说明 |
|---|
| media_id | string | 上传后的素材标识(最大 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 | 电商能力未开通 | 先开通电商能力 |