微信接口整理

1.获取access_token

http请求方式: GET
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

参数说明

参数	是否必须	说明
grant_type	是	获取access_token填写client_credential
appid	是	第三方用户唯一凭证
secret	是	第三方用户唯一凭证密钥，即appsecret

返回说明

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

参数	说明
access_token	获取到的凭证
expires_in	凭证有效时间，单位：秒

2.获取微信服务器ip

http请求方式: GET
https://api.weixin.qq.com/cgi-bin/getcallbackip?access_token=ACCESS_TOKEN

参数说明

参数	是否必须	说明
access_token	是	公众号的access_token

返回说明
正常情况下，微信会返回下述JSON数据包给公众号：

{
"ip_list":["127.0.0.1","127.0.0.1"]
}

参数	说明
ip_list	微信服务器IP地址列表

3.客服接口
必须在公众号平台上为公众号设置微信号后才能使用，每个公众号最多添加10个客服号

3.1添加客服账号

http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN

POST数据示例如下：

{
"kf_account" : "test1@test",
"nickname" : "客服1",
"password" : "pswmd5",
}

返回说明（正确时的JSON返回结果）：

{
"errcode" : 0,
"errmsg" : "ok",
}

3.2 修改客服账号

http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN

POST数据示例如下：

{
"kf_account" : "test1@test",
"nickname" : "客服1",
"password" : "pswmd5",
}

返回说明（正确时的JSON返回结果）：

{
"errcode" : 0,
"errmsg" : "ok",
}

3.3 删除客服账号

开发者可以通过该接口为公众号删除客服帐号。该接口调用请求如下：

http请求方式: GET
https://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN

POST数据示例如下：

{
"kf_account" : "test1@test",
"nickname" : "客服1",
"password" : "pswmd5",
}

返回说明（正确时的JSON返回结果）：

{
"errcode" : 0,
"errmsg" : "ok",
}

3.4 设置客服的头像

http请求方式: POST/FORM
http://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT
调用示例：使用curl命令，用FORM表单方式上传一个多媒体文件，curl命令的具体用法请自行了解

返回说明（正确时的JSON返回结果）：

{
"errcode" : 0,
"errmsg" : "ok",
}

3.5 获取所有客服

http请求方式: GET
https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN

参数	是否必须	说明
access_token	是	调用接口凭证
kf_account	是	完整客服账号，格式为：账号前缀@公众号微信号
kf_nick	是	客服昵称
kf_id	是	客服工号
nickname	是	客服昵称，最长6个汉字或12个英文字符
password	否	客服账号登录密码，格式为密码明文的32位加密MD5值。该密码仅用于在公众平台官网的多客服功能中使用，若不使用多客服功能，则不必设置密码
media	是	该参数仅在设置客服头像时出现，是form-data中媒体文件标识，有filename、filelength、content-type等信息

3.6客服发送信息

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN

4.上传图文信息

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN
调用示例（使用curl命令，用FORM表单方式上传一个图片）：
curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"

5.模板消息规范

5.1设置公众号所处行业

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token=ACCESS_TOKEN

POST数据示例如下：

{
"industry_id1":"1",
"industry_id2":"4"
}

5.2获取模板id

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=ACCESS_TOKEN

5.3发送模板信息

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

公众号主动调用API的情况将不受影响，只有被动回复用户消息时，才需要进行信息加解密