微信接口整理
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 | 凭证有效时间，单位：秒 |
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地址列表 |
必须在公众号平台上为公众号设置微信号后才能使用，每个公众号最多添加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 [email protected] "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的情况将不受影响，只有被动回复用户消息时，才需要进行信息加解密