微信公众号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接口还有问题，微信官方在下个版本修改。(2017年6月8日前已经修改)