微信接口整理

来源:互联网 发布:淘宝极速退款的条件 编辑:程序博客网 时间:2024/05/20 22:30

1.获取access_token


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

参数说明

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

返回说明

{"access_token":"ACCESS_TOKEN","expires_in":7200}
参数说明access_token获取到的凭证expires_in凭证有效时间,单位:秒2.获取微信服务器ip

http请求方式: GEThttps://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请求方式: POSThttps://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请求方式: POSThttps://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请求方式: GEThttps://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/FORMhttp://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请求方式: GEThttps://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请求方式: POSThttps://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN


4.上传图文信息

http请求方式: POSThttps://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请求方式: POSThttps://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请求方式: POSThttps://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=ACCESS_TOKEN

5.3发送模板信息

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


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



0 0
原创粉丝点击