Add permanent material
Add permanent material
In addition to temporary materials that will expire in 3 days, developers sometimes need to save some materials permanently. At that time, they can add permanent materials through this interface. material.
Recently updated, after the permanent picture material is added, the URL will be returned to the developer. The developer can use it within the Tencent domain name (if used outside the Tencent domain name, the picture will be blocked).
Please note:
1. The newly added permanent materials can also be seen in the material management module of the official website of the public platform
2. The number of permanent materials is If there is an upper limit, please add it with caution. The upper limit of graphic message materials and picture materials is 5000, and the upper limit of other types is 1000
3. The format and size of the materials are consistent with the official website of the public platform. Specifically, the image size does not exceed 2M, supports bmp/png/jpeg/jpg/gif format, the voice size does not exceed 5M, the length does not exceed 60 seconds, and supports mp3/wma/wav/amr format
4, Calling this interface requires https protocol
Add permanent graphics and text materials
Interface call request instructions
Call example
Parameter Description
is the specific content of the ##content_source_url graphic message, that is, click "Read the original text" The following URLReturn instructions
"media_id":MEDIA_ID
}
The returned is the media_id of the newly added graphic message material.
Please note that in the specific content of graphic messages, external image links will be filtered. Developers can upload images through the following interface to obtain the URL and put them into graphic content for use.
Upload the picture in the graphic message to obtain the URL Please note that the pictures uploaded by this interface do not occupy the 5,000 limit of the number of pictures in the public account's material library. Images only support jpg/png format, and the size must be less than 1MB.
Interface call request description
http request method: POST
https://api.weixin.qq.com/cgi- bin/media/uploadimg?access_token=ACCESS_TOKEN
Call example (use curl command to upload an image using FORM form):
curl -F media=@test.jpg "https:/ /api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"
Parameter Description
| Parameter | Is it necessary | Description |
| title | is | title |
| thumb_media_id | is the cover picture material id of the | graphic message (must be a permanent mediaID) |
| author | 是 | author |
| digest | 是 | Summary of graphic and text messages. Only single graphic and text messages have abstracts. Multiple graphic and text messages are left empty. |
| ##show_cover_pic | is | whether to display the cover, 0 is false, that is, it is not displayed, 1 is true, that is, it is displayed |
| ##content | graphic message. It supports HTML tags and must be less than 20,000 characters and less than 1M, and JS# will be removed here. | |
| is the original address of the |
Return instructions The return result under normal circumstances is:
{
"url": "http://mmbiz.qpic.cn/ mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0"
}
The url is the URL of the uploaded image, which can be used in subsequent group sending and placed in graphic messages.
Add other types of permanent materials
Interface call request instructions
Call the interface through the POST form, the form id is media, contains the material content that needs to be uploaded, including filename, filelength, content-type and other information. Please note: Picture materials will enter the default group in the material management module of the official website of the public platform.
http request method: POST, need to use https
https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE
Call example (use the curl command to add another type of permanent material using the FORM form. Please refer to the information for the use of the curl command)
Parameter Description
| Parameter | Is it necessary | Description |
| access_token | is | Call interface credentials |
| media | is the media file identifier in | ##form-data, including filename, filelength, content-type and other information |
Special attention should be paid to adding permanent video materials
When uploading video materials, you need to POST another form with the id of description, which contains the description information of the material. The content format is JSON and the format is as follows:
"title":VIDEO_TITLE,
"introduction":INTRODUCTION
}
Call example of adding permanent video material:
Parameter Description
| Parameter | Is it required | Description |
| access_token | is | 调用接口凭证 |
| type | 是 | 媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb） |
| media | is the media file identifier in | ##form-data, including filename, filelength, content-type and other information |
| Parameter | Is it necessary | Description |
| title | is the title of the | video material |
| introduction | is the description of the | video material |
Return description
"media_id":MEDIA_ID,
"url":URL
}
Return parameter description
| Parameters | Description |
| media_id | The media_id of the new permanent material |
| url | The image URL of the newly added image material (this field will be returned only when adding image material) |
An example of the returned JSON data packet in error conditions is as follows (the example is an invalid media type error):
