# 获取草稿列表 [调试诊断](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_tools) > 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。 接口英文名：draft_batchget 新增草稿之后，可用本接口获取草稿列表信息 ## 1. 调用方式 ### HTTPS 调用 ```bash POST https://api.weixin.qq.com/cgi-bin/draft/batchget?access_token=ACCESS_TOKEN ``` ### 云调用 - 本接口不支持云调用。 ### 第三方调用 - 本接口支持第三方平台代商家调用。 - 该接口所属的权限集 id 为：11、100 - 服务商获得其中之一权限集授权后，可通过使用 [authorizer_access_token](/doc/oplatform/developers/dev/AuthorizerAccessToken.md) 代商家进行调用，具体可查看 [第三方调用](/doc/oplatform/Third-party_Platforms/2.0/Before_Develop/call_interface.md) 说明文档。 ## 2. 请求参数 ### 查询参数 `Query String Parameters` ```json [ { "参数名": "access_token", "类型": "string", "必填": "是", "说明": "接口调用凭证，可使用 [access_token](/doc/service/api/base/api_getaccesstoken)、[authorizer_access_token](/doc/oplatform/openApi/ticket-token/api_getauthorizeraccesstoken.md)" } ] ``` ### 请求体 `Request Payload` ```json [ { "参数名": "offset", "类型": "number", "必填": "是", "示例": "0", "说明": "从全部素材的该偏移位置开始返回，0表示从第一个素材返回" }, { "参数名": "count", "类型": "number", "必填": "是", "示例": "10", "说明": "返回素材的数量，取值在1到20之间" }, { "参数名": "no_content", "类型": "number", "必填": "否", "示例": "1", "说明": "1 表示不返回 content 字段，0 表示正常返回，默认为 0" } ] ``` ## 3. 返回参数 ### 返回体 `Response Payload` ```json [ { "参数名": "total_count", "类型": "number", "说明": "草稿素材的总数" }, { "参数名": "item_count", "类型": "number", "说明": "本次调用获取的素材的数量" }, { "参数名": "item", "类型": "objarray", "说明": "素材列表" } ] ``` "> ### Res.item(Array) `Object Payload` 素材列表 ```json [ { "参数名": "media_id", "类型": "string", "说明": "图文消息的id" }, { "参数名": "content", "类型": "object", "说明": "图文消息内容" }, { "参数名": "update_time", "类型": "number", "说明": "图文消息更新时间" } ] ``` __content"> ### Res.item(Array).content `Object Payload` 图文消息内容 ```json [ { "参数名": "news_item", "类型": "objarray", "说明": "图文内容列表" } ] ``` __content__news_item"> ### Res.item(Array).content.news_item `Object Payload` 图文内容列表 ```json [ { "参数名": "article_type", "类型": "string", "说明": "文章类型，分别有图文消息（news）、图片消息（newspic），不填默认为图文消息（news）" }, { "参数名": "title", "类型": "string", "说明": "标题" }, { "参数名": "author", "类型": "string", "说明": "作者" }, { "参数名": "digest", "类型": "string", "说明": "图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空。如果本字段为没有填写，则默认抓取正文前54个字。" }, { "参数名": "content", "类型": "string", "说明": "图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS,涉及图片url必须来源 \"上传图文消息内的图片获取URL\"接口获取。外部图片url将被过滤。 图片消息则仅支持纯文本和部分特殊功能标签如商品，商品个数不可超过50个" }, { "参数名": "content_source_url", "类型": "string", "说明": "图文消息的原文地址，即点击“阅读原文”后的URL" }, { "参数名": "thumb_media_id", "类型": "string", "说明": "图文消息的封面图片素材id（必须是永久MediaID）" }, { "参数名": "need_open_comment", "类型": "number", "说明": "是否打开评论，0不打开(默认)，1打开" }, { "参数名": "only_fans_can_comment", "类型": "number", "说明": "是否粉丝才可评论，0所有人可评论(默认)，1粉丝才可评论" }, { "参数名": "image_info", "类型": "object", "说明": "图片消息里的图片相关信息，图片数量最多为20张，首张图片即为封面图" }, { "参数名": "cover_info", "类型": "object", "说明": "封面信息，图文消息（news）和图片消息（newspic）均适用" }, { "参数名": "product_info", "类型": "object", "说明": "商品信息" }, { "参数名": "url", "类型": "string", "说明": "草稿的临时链接" } ] ``` __content__news_item__image_info"> ### Res.item(Array).content.news_item.image_info `Object Payload` 图片消息里的图片相关信息，图片数量最多为20张，首张图片即为封面图 ```json [ { "参数名": "image_list", "类型": "objarray", "说明": "图片列表" } ] ``` __content__news_item__image_info__image_list"> ### Res.item(Array).content.news_item.image_info.image_list `Object Payload` 图片列表 ```json [ { "参数名": "image_media_id", "类型": "string", "说明": "图片消息里的图片素材id（必须是永久MediaID）" } ] ``` __content__news_item__cover_info"> ### Res.item(Array).content.news_item.cover_info `Object Payload` 封面信息，图文消息（news）和图片消息（newspic）均适用 ```json [ { "参数名": "crop_percent_list", "类型": "objarray", "说明": "封面裁剪信息。以图片左上角（0,0）、右下角（1,1）建立平面坐标系，裁剪区域左上角坐标为 x1、y1，右下角坐标为 x2、y2" } ] ``` __content__news_item__cover_info__crop_percent_list"> ### Res.item(Array).content.news_item.cover_info.crop_percent_list `Object Payload` 封面裁剪信息。以图片左上角（0,0）、右下角（1,1）建立平面坐标系，裁剪区域左上角坐标为 x1、y1，右下角坐标为 x2、y2 ```json [ { "参数名": "ratio", "类型": "string", "说明": "裁剪比例，包括“1_1”“16_9”“2.35_1”三种规格" }, { "参数名": "x1", "类型": "string", "说明": "裁剪区域左上角的横坐标" }, { "参数名": "y1", "类型": "string", "说明": "裁剪区域左上角的纵坐标" }, { "参数名": "x2", "类型": "string", "说明": "裁剪区域右下角的横坐标" }, { "参数名": "y2", "类型": "string", "说明": "裁剪区域右下角的纵坐标" } ] ``` __content__news_item__product_info"> ### Res.item(Array).content.news_item.product_info `Object Payload` 商品信息 ```json [ { "参数名": "footer_product_info", "类型": "object", "说明": "文末插入商品相关信息" } ] ``` __content__news_item__product_info__footer_product_info"> ### Res.item(Array).content.news_item.product_info.footer_product_info `Object Payload` 文末插入商品相关信息 ```json [ { "参数名": "product_key", "类型": "string", "说明": "商品key" } ] ``` ## 4. 注意事项 本接口无特殊注意事项 ## 5. 代码示例 请求示例 ``` json { "offset": 0, "count": 10, "no_content": 1 } ``` 返回示例 ``` json { "total_count":TOTAL_COUNT, "item_count":ITEM_COUNT, "item":[ { "media_id":MEDIA_ID, "content": { "news_item" : [ { "article_type":"news", "title":TITLE, "author":AUTHOR, "digest":DIGEST, "content":CONTENT, "content_source_url":CONTENT_SOURCE_URL, "thumb_media_id":THUMB_MEDIA_ID, "need_open_comment":0, "only_fans_can_comment":0, "cover_info":{ "crop_percent_list":[ { "ratio":"2.35_1", "x1":"0.1945", "y1":"0", "x2":"1", "y2":"0.5236" }, { "ratio":"1_1", "x1":"0", "y1":"0", "x2":"1", "y2":"1" } ] }, "url":URL }, { "article_type":"newspic", "title":TITLE, "content":CONTENT, "thumb_media_id":THUMB_MEDIA_ID, "need_open_comment":0, "only_fans_can_comment":0, "image_info":{ "image_list":[ { "image_media_id":IMAGE_MEDIA_ID } ] }, "cover_info":{ "crop_percent_list":[ { "ratio":"1_1", "x1":"0.166454", "y1":"0", "x2":"0.833545", "y2":"1" } ] }, "product_info": { "footer_product_info": { "product_key":PRODUCT_KEY } }, "url":URL } ] }, "update_time": UPDATE_TIME } ] } ``` ## 6. 错误码 以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/oplatform/developers/errCode/README.md)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。 ```json [ { "错误码": "0", "错误描述": "成功", "解决方案": "ok是指从不正常变成正常 in a normal state是指本来就正常" } ] ``` ## 7. 适用范围 本接口在不同账号类型下的可调用情况： ```json [ { "公众号": "✔", "服务号": "✔" } ] ``` - ✔：该账号可调用此接口。 - 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。