# 上传图文消息素材

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

接口英文名：uploadnewsmsg

本接口用于上传图文消息，该能力已更新为草稿箱

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用

# 第三方调用

本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：1、7-9、11、100
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String parameters`

参数名	类型	必填	说明
access_token	string	是	接口调用凭证，可使用 access_token、authorizer_access_token

# 请求体 `Request Payload`

参数名	类型	必填	说明
articles	objarray	是	图文消息，一个图文消息支持1到8条图文

# Body.articles(Array) `Object Payload`

参数名	类型	必填	说明
title	string	是	图文消息的标题
author	string	否	图文消息的作者
thumb_media_id	string	是	图文消息缩略图的media_id，可以在素材管理-新增临时素材中获得
content	string	是	图文消息页面的内容，支持HTML标签。具备微信支付权限的公众号，可以使用a标签，其他公众号不能使用。
content_source_url	string	否	在图文消息页面点击“阅读原文”后的页面，受安全限制，如需跳转Appstore，可以使用itun.es或appsto.re的短链服务，并在短链后增加 #wechat_redirect 后缀。
digest	string	否	图文消息的描述，如本字段为空，则默认抓取正文前64个字
show_cover_pic	number	否	是否显示封面，1为显示，0为不显示
need_open_comment	number	否	是否打开评论，0不打开，1打开
only_fans_can_comment	-	否	是否粉丝才可评论，0所有人可评论，1粉丝才可评论

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
type	string	媒体文件类型，图文消息（news）
media_id	string	图文消息上传后获取的唯一标识
created_at	string	媒体文件上传时间

# 4. 注意事项

如果需要在群发图文中插入小程序，则在调用上传图文消息素材接口时，需在content字段中添加小程序跳转链接，有以下三种样式的可供选择。

小程序卡片跳转小程序，代码示例：

<mp-common-miniprogram data-miniprogram-appid="wx123123123" data-miniprogram-path="pages/index/index" data-miniprogram-title="小程序示例" data-miniprogram-imageurl="http://example.com/demo.jpg" data-miniprogram-type="card"></mp-common-miniprogram>

文字跳转小程序，代码示例：

<p><a data-miniprogram-appid="wx123123123" data-miniprogram-path="pages/index" href="">点击文字跳转小程序</a></p>

图片跳转小程序，代码示例：

<p><a data-miniprogram-appid="wx123123123" data-miniprogram-path="pages/index" href=""><img src="https://mmbiz.qpic.cn/mmbiz_jpg/demo/0?wx_fmt=jpg" alt="" data-width="null" data-ratio="NaN"></a></p>

# 5. 代码示例

请求示例

{
   "articles": [	 
        {
            "thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p",
            "author":"xxx",		
            "title":"Happy Day",		 
            "content_source_url":"www.qq.com",		
            "content":"content",		 
            "digest":"digest",
            "show_cover_pic":1,
            "need_open_comment":1,
            "only_fans_can_comment":1
        },	 
        {
            "thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p",
            "author":"xxx",		
            "title":"Happy Day",		 
            "content_source_url":"www.qq.com",		
            "content":"content",		 
            "digest":"digest",
            "show_cover_pic":0,
            "need_open_comment":1,
            "only_fans_can_comment":1
        }
   ]
}

返回示例

{
   "type":"news",
   "media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ",
   "created_at":1391857799
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码

错误码	错误描述	解决方案
0	ok或者in a normal state	ok是指从不正常变成正常 in a normal state是指本来就正常

# 7. 适用范围

本接口在不同账号类型下的可调用情况：

公众号	服务号
✔	✔

✔：该账号可调用此接口
其他未明确声明的账号类型，如无特殊说明，均不可调用此接口；