微信公众号API使用总结

使用过程的总结，记录备忘

官网： https://mp.weixin.qq.com/

API: http://mp.weixin.qq.com/wiki/home/index.html
接口调试工具：http://mp.weixin.qq.com/debug

1. 获取token:（GET）

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=SECRET

请求参数：

grant_type	是	获取access_token填写client_credential
appid	是	第三方用户唯一凭证
secret	是	第三方用户唯一凭证密钥，即appsecret

返回值：

{"access_token":"ACCESS_TOKEN","expires_in":7200}

2、上传图像接口（POST、Multipart）

http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

获取媒体件ID（media_id）、图片URL，为下一步做准备。

3、上传素材（POST、）

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

参数：

上传待发布素材，获取mediaId。

注意：内容中有图片的使用2步骤中的替换。①图文外显图②内容中图片。

4、获取人员

1获取全部用户。

、https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID

参数	是否必须	说明
access_token	是	调用接口凭证
next_openid	是	第一个拉取的OPENID，不填默认从头开始拉取

正确时返回JSON数据包：

{"total":2,"count":2,"data":{"openid":["","OPENID1","OPENID2"]},"next_openid":"NEXT_OPENID"}

2、获取用户分组

https://api.weixin.qq.com/cgi-bin/groups/get?access_token=ACCESS_TOKEN

5、预览接口（提供预览功能）

https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=ACCESS_TOKEN

请求参数：

参数	说明
touser	接收消息用户对应该公众号的openid，该字段也可以改为towxname，以实现对微信号的预览
msgtype	群发的消息类型，图文消息为mpnews，文本消息为text，语音为voice，音乐为music，图片为image，视频为video，卡券为wxcard
media_id	用于群发的消息的media_id
content	发送文本消息时文本的内容

{

"touser":[

"OPENID1",

"OPENID2"

],

"mpnews":{

"media_id":"123dsdajkasd231jhksad"

},

"msgtype":"mpnews"

}

注：towxname，参数可替换touser参数。towxname传微信账号。如下：

{

"towxname": "jiawenbo89",

"mpnews":{

"media_id":"123dsdajkasd231jhksad"

},

"msgtype":"mpnews"

}

6、群发（服务号：4条/月）

https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN。

群发接口使用同预览接口。

7、永久素材（在微信后台保存）

1、久图文素材

https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN

2、永久其他素材（音、视、图）

https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE



3、视频永久上传

在2的基础上再提交另一个表单



注意：现在视频API接口还有问题，微信官方在下个版本修改。