# 上传图文消息素材

[调试诊断](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_tools)

> 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。

接口英文名：uploadnewsmsg

本接口用于上传图文消息，该能力已更新为[草稿箱](/doc/service/api/draftbox/draftmanage/api_draft_add)

## 1. 调用方式

### HTTPS 调用

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

### 云调用

- 本接口不支持云调用。

### 第三方调用

- 本接口支持第三方平台代商家调用。

- 该接口所属的权限集 id 为：1、7-9、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
[
  {
    "参数名": "articles",
    "类型": "objarray",
    "必填": "是",
    "说明": "图文消息，一个图文消息支持1到8条图文"
  }
]
```

">

### Body.articles(Array) `Object Payload`

图文消息，一个图文消息支持1到8条图文

```json
[
  {
    "参数名": "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`

```json
[
  {
    "参数名": "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. 代码示例

请求示例

``` json
{
   "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
        }
   ]
}
```

返回示例

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

## 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",
    "解决方案": "ok是指从不正常变成正常 in a normal state是指本来就正常"
  }
]
```

## 7. 适用范围

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

```json
[
  {
    "公众号": "仅认证",
    "服务号": "仅认证"
  }
]
```

- 仅认证：表示仅允许企业主体已认证账号调用，未认证或不支持认证的账号无法调用。
- 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。