API | 获取用户数据 |
---|---|
uri | /openwx/get_user_info |
请求方法 | GET|POST |
请求参数 | 无 |
调用示例 | http://127.0.0.1:3000/openwx/get_user_info |
返回数据:
{
"account": "xxx",
"name": "xxx",
"markname": "",
"sex": "none",
"display": "",
"city": "",
"signature": "帮助解决微信支付中遇到的困难,收集关于微信支付的建议反馈。",
"province": "广东",
"id": "@efc5f86c30df4b9c80e98ac428e0e257",
"displayname": "xxx"
},
API | 获取好友数据 |
---|---|
uri | /openwx/get_friend_info |
请求方法 | GET|POST |
请求参数 | 无 |
调用示例 | http://127.0.0.1:3000/openwx/get_friend_info |
返回JSON数组: |
[#好友数组
{#第一个好友
"account": "wxzhifu",
"name": "微信支付",
"markname": "",
"sex": "none",
"display": "",
"city": "",
"signature": "帮助解决微信支付中遇到的困难,收集关于微信支付的建议反馈。",
"province": "广东",
"id": "@efc5f86c30df4b9c80e98ac428e0e257",
"displayname": "微信支付"
},
{#第二个好友
"account": "",
"name": "财付通",
"markname": "",
"sex": "none",
"display": "",
"city": "深圳",
"signature": "会支付 会生活",
"province": "广东",
"id": "@00227d73fa6b8326f69bca419db7a05c",
"displayname": "财付通"
}
]
API | 获取群组数据 |
---|---|
uri | /openwx/get_group_info |
请求方法 | GET|POST |
请求参数 | 无 |
调用示例 | http://127.0.0.1:3000/openwx/get_group_info |
返回JSON数组: |
[#群数组
{#第一个群
"name": "",
"id": "@@dadadadada",
"displayname": "xxxx"
"member": [#群成员数组
{#第一个群成员
"account": "",
"name": "xxx",
"markname": "",
"sex": "none",
"display": "",
"city": "",
"signature": "",
"province": "",
"id": "@adadada",
"displayname": "xxx"
},
{#第二个群成员
"account": "",
"name": "xxx",
"markname": "",
"sex": "none",
"display": "",
"city": "",
"signature": "",
"province": "",
"id": "@dadada",
"displayname": "xxx"
},
],
},
{#第二个群组
"name": "xxxx",
"id": "@@dadadada",
"displayname": "xxx"
"member": [
{
"account": "",
"name": "xxx",
"markname": "",
"sex": "none",
"display": "",
"city": "",
"signature": "",
"province": "",
"id": "@dadadada",
"displayname": "xxx"
},
{
"account": "",
"name": "xxx",
"markname": "",
"sex": "none",
"display": "",
"city": "",
"signature": "",
"province": "",
"id": "@dadadada",
"displayname": "xxx"
},
],
},
]
API | 发送好友消息 |
---|---|
uri | /openwx/send_friend_message |
请求方法 | GET|POST |
请求参数 | id: 好友的id account: 好友的帐号 displayname: 好友显示名称 markname: 好友备注名称 media_path:媒体路径(可以是文件路径或url,需要做urlencode) |
数据格式 | application/x-www-form-urlencoded |
调用示例 | http://127.0.0.1:3000/openwx/send_friend_message?id=xxxx&content=hello http://127.0.0.1:3000/openwx/send_friend_message?markname=xxx&content=%e4%bd%a0%e5%a5%bd http://127.0.0.1:3000/openwx/send_friend_message?id=xxx&media_path=https%3a%2f%2fss0.bdstatic.com%2f5aV1bjqh_Q23odCf%2fstatic%2fsuperman%2fimg%2flogo%2fbd_logo1_31bdc765.png |
特殊处理:id=@all 表示群发消息给所有的好友 | |
返回JSON数组: |
{"status":"发送成功","msg_id":23910327,"code":0} #code为 0 表示发送成功
API | 发送群组消息 |
---|---|
uri | /openwx/send_group_message |
请求方法 | GET|POST |
请求参数 | id: 群组的id displayname: 群组显示名称 media_path:媒体路径(可以是文件路径或url,需要做urlencode) |
数据格式 | application/x-www-form-urlencoded |
调用示例 | http://127.0.0.1:3000/openwx/send_group_message?id=xxxx&content=hello http://127.0.0.1:3000/openwx/send_group_message?displayname=xxx&content=%e4%bd%a0%e5%a5%bd http://127.0.0.1:3000/openwx/send_group_message?id=xxx&media_path=https%3a%2f%2fss0.bdstatic.com%2f5aV1bjqh_Q23odCf%2fstatic%2fsuperman%2fimg%2flogo%2fbd_logo1_31bdc765.png http://127.0.0.1:3000/openwx/send_group_message?displayname=xxx&media_path=https%3a%2f%2fss0.bdstatic.com%2f5aV1bjqh_Q23odCf%2fstatic%2fsuperman%2fimg%2flogo%2fbd_logo1_31bdc765.png |
返回JSON数组: |
{"status":"发送成功","msg_id":23910327,"code":0} #code为 0 表示发送成功
API | 接收消息上报(支持好友消息、群消息) |
---|---|
uri | 自定义任意支持http协议的url |
请求方法 | POST |
数据格式 | application/json |
需要加载Openwx插件时通过 post_api
参数来指定上报地址:
$client->load("Openwx",data=>{
listen => [{host=>xxx,port=>xxx}], #可选,发送消息api监听端口
post_api=> 'http://127.0.0.1:4000/post_api', #可选,接收消息或事件的上报地址
post_event => 1, #可选,是否上报事件,为了向后兼容性,默认值为0
post_media_data => 1, #可选,是否上报经过urlencode编码的图片原始数据,默认值为1
});
当接收到消息时,会把消息通过JSON格式数据POST到该接口
connect to 127.0.0.1 port 4000
POST /post_api
Accept: */*
Content-Length: xxx
Content-Type: application/json
{ "receiver":"小灰",
"time":"1442542632",
"content":"测试一下",
"class":"recv",
"sender_id":"@2372835507",
"receiver_id":"@4072574066",
"group":"PERL学习交流",
"group_id":"@@2617047292",
"sender":"灰灰",
"id":"10856",
"type":"group_message",
"format": "text",
"post_type": "receive_message"
}
发送的消息会通过JSON格式数据POST到该接口
connect to 127.0.0.1 port 4000
POST /post_api
Accept: */*
Content-Length: xxx
Content-Type: application/json
{ "receiver":"小灰",
"time":"1442542632",
"content":"测试一下",
"class":"send",
"sender_id":"@2372835507",
"receiver_id":"@4072574066",
"group":"PERL学习交流",
"group_id":"@@2617047292",
"sender":"灰灰",
"id":"10856",
"type":"group_message",
"format": "text",
"post_type": "send_message"
}
图片消息上报
{ "receiver":"小灰",
"time":"1442542632",
"content":"[media](\/tmp\/mojo_weixin_media_Ja9l.jpg)",
"media_path": "\/tmp\/mojo_weixin_media_Ja9l.jpg",
"media_id": "2273934420223351581",
"media_mime":"image\/jpg",
"media_name": "mojo_weixin_media_Ja9l.jpg",
"media_size": "1234567",
"media_mtime": "1462763788",
"media_ext": "jpg",
"media_data": "%87%60M%B4A%E1%EB%A0%13%E4%C4%5C2%C4%0B%DFV%B7%0B...", #对图片原始二进制数据,使用url encode编码
"class":"recv",
"sender_id":"@2372835507",
"receiver_id":"@4072574066",
"group":"PERL学习交流",
"group_id":"@@2617047292",
"sender":"灰灰",
"id":"10856",
"type":"group_message",
"format": "media",
"post_type": "receive_message"
}
一般情况下,post_api接口返回的响应内容可以是随意,会被忽略,上报完不做其他操作 如果post_api接口返回的数据类型是 text/json 或者 application/json,并且json格式形式如下:
HTTP/1.1 200 OK
Connection: close
Content-Type: application/json;charset=UTF-8
Date: Mon, 29 Feb 2016 05:53:31 GMT
Content-Length: 27
Server: Mojolicious (Perl)
{"reply":"你好","code":0} #要回复消息,必须包含reply的属性,其他属性有无并不重要
则表示希望通过post_api响应的内容来直接回复该消息,会直接对上报的该条消息进行回复,回复的内容为 "你好"
当事件发生时,会把事件相关信息上报到指定的接口,当前支持上报的事件包括:
事件名称 | 事件说明 | 上报参数列表 |
---|---|---|
new_group | 新加入群聊 | 对应群对象 |
new_friend | 新增好友 | 对应好友对象 |
new_group_member | 新增群聊成员 | 对应成员对象,对应的群对象 |
lose_group | 退出群聊 | 对应群对象 |
lose_friend | 删除好友 | 对应好友对象 |
lose_group_member | 成员退出群聊 | 对应成员对象,对应的群对象 |
group_property_change | 群聊属性变化 | 群对象,属性,原始值,更新值 |
group_member_property_change | 成员属性变化 | 成员对象,属性,原始值,更新值 |
friend_property_change | 好友属性变化 | 好友对象,属性,原始值,更新值 |
user_property_change | 帐号属性变化 | 账户对象,属性,原始值,更新值 |
connect to 127.0.0.1 port 4000
POST /post_api
Accept: */*
Content-Length: xxx
Content-Type: application/json
{
"post_type":"event",
"event":"new_friend",
"params":[
{
"account":"ms-xiaoice",
"name":"小冰",
"markname":"",
"sex":"0",
"city":"海淀",
"signature":"我是人工智能微软小冰,我回来了,吼吼~~",
"province":"北京",
"displayname":"小冰",
"id":"@75b9db5ae52c87361d1800eaaf307f4d"
}
],
}
可以通过上报的json数组中的post_type
来区分上报的数据数接收到的消息还是事件
API | 发送消息给好友并等待好友回答 |
---|---|
uri | /openwx/consult |
请求方法 | GET|POST |
请求参数 | id: 好友的id account: 好友的帐号 displayname: 好友显示名称 markname: 好友备注名称 timeout:等待回复的时间,默认30秒 media_path:媒体路径(可以是文件路径或url,需要做urlencode) |
数据格式 | application/x-www-form-urlencoded |
调用示例 | http://127.0.0.1:3000/openwx/consult?account=ms-xiaoice&content=haha http://127.0.0.1:3000/openwx/consult?account=ms-xiaoice&media_path=%2ftmp%2fhello.jpg |
主要应用场景是把小冰(微信帐号ms-xiaoice)的智能回复封装成接口,给小冰发好友消息前,你需要先关注小冰的公众号
GET /openwx/consult?account=ms-xiaoice&content=haha HTTP/1.1
User-Agent: curl/7.29.0
Host: 127.0.0.1:3000
Accept: */*
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 01 Mar 2016 07:25:11 GMT
Content-Length: 94
Server: Mojolicious (Perl)
{"reply":"哈哈,有什么事情","status":"发送成功","msg_id":"2683625013724723712","code":0}
超时失败时的返回结果:
{"reply":null,"reply_status":"reply timeout","status":"发送成功","msg_id":1456817344504,"code":0}
API | 搜索好友对象 |
---|---|
uri | /openwx/search_friend |
请求方法 | GET|POST |
请求参数 | 好友对象的任意属性,中文需要做urlencode,比如: id: 好友的id account: 好友的帐号 displayname: 好友显示名称 markname: 好友备注名称 |
数据格式 | application/x-www-form-urlencoded |
调用示例 | http://127.0.0.1:3000/openwx/search_friend?id=xxxxxx http://127.0.0.1:3000/openwx/search_friend?province=xxxxxx&city=xxxx |
返回JSON数组: |
[#好友数组
{#第一个好友
"account": "wxzhifu",
"name": "微信支付",
"markname": "",
"sex": "none",
"display": "",
"city": "",
"signature": "帮助解决微信支付中遇到的困难,收集关于微信支付的建议反馈。",
"province": "广东",
"id": "@efc5f86c30df4b9c80e98ac428e0e257",
"displayname": "微信支付"
},
{#第二个好友
"account": "",
"name": "财付通",
"markname": "",
"sex": "none",
"display": "",
"city": "深圳",
"signature": "会支付 会生活",
"province": "广东",
"id": "@00227d73fa6b8326f69bca419db7a05c",
"displayname": "财付通"
}
]
API | 搜索群组对象 |
---|---|
uri | /openwx/search_group |
请求方法 | GET|POST |
请求参数 | 群对象的任意属性,中文需要做urlencode,比如: id: 群组的id displayname: 群组的显示名称 |
数据格式 | application/x-www-form-urlencoded |
调用示例 | http://127.0.0.1:3000/openwx/search_group?id=xxxxxx http://127.0.0.1:3000/openwx/search_group?displayname=xxxxx |
返回JSON数组: |
[#群数组
{#第一个群
"name": "",
"id": "@@dadadadada",
"displayname": "xxxx"
"member": [#群成员数组
{#第一个群成员
"account": "",
"name": "xxx",
"markname": "",
"sex": "none",
"display": "",
"city": "",
"signature": "",
"province": "",
"id": "@adadada",
"displayname": "xxx"
},
{#第二个群成员
"account": "",
"name": "xxx",
"markname": "",
"sex": "none",
"display": "",
"city": "",
"signature": "",
"province": "",
"id": "@dadada",
"displayname": "xxx"
},
],
},
{#第二个群组
"name": "xxxx",
"id": "@@dadadada",
"displayname": "xxx"
"member": [
{
"account": "",
"name": "xxx",
"markname": "",
"sex": "none",
"display": "",
"city": "",
"signature": "",
"province": "",
"id": "@dadadada",
"displayname": "xxx"
},
{
"account": "",
"name": "xxx",
"markname": "",
"sex": "none",
"display": "",
"city": "",
"signature": "",
"province": "",
"id": "@dadadada",
"displayname": "xxx"
},
],
},
]
API | 创建群组 |
---|---|
uri | /openwx/create_group |
请求方法 | GET|POST |
请求参数 | friend: 好友的id(多个好友id用逗号分割) displayname: 可选,群组的显示名称 |
数据格式 | application/x-www-form-urlencoded |
调用示例 | http://127.0.0.1:3000/openwx/create_group?displayname=xxxxxx&friend=xxxx,xxxx |
返回JSON结果: |
{
"group_id":"@@a6588c3bfa8b5458ffc8d758ae851d3f40f396c2ebc970d006a365fdbb5299e1", #创建的群组id
"status":"success",
"code":0 #创建成功状态码为0,失败为非0
}
API | 邀请好友加入群组 |
---|---|
uri | /openwx/invite_friend |
请求方法 | GET|POST |
请求参数 | friend: 好友的id(多个好友id用逗号分割) id: 群组对象的id displayname: 群组的显示名称 |
数据格式 | application/x-www-form-urlencoded |
调用示例 | http://127.0.0.1:3000/openwx/invite_friend?id=xxxxxx&friend=xxxx,xxxx http://127.0.0.1:3000/openwx/invite_friend?displayname=xxxxxx&friend=xxxx,xxxx |
返回JSON结果: |
{
"status":"success",
"code":0 #成功状态码为0,失败为非0
}
API | 移除群组成员 |
---|---|
uri | /openwx/kick_group_member |
请求方法 | GET|POST |
请求参数 | member: 成员的id(多个成员id用逗号分割) id: 群组的id displayname: 群组的显示名称 |
数据格式 | application/x-www-form-urlencoded |
调用示例 | http://127.0.0.1:3000/openwx/kick_group_member?id=xxxxxx&member=xxxx,xxxx http://127.0.0.1:3000/openwx/kick_group_member?displayname=xxxxxx&member=xxxx,xxxx |
返回JSON结果: |
{
"status":"success",
"code":0 #成功状态码为0,失败为非0
}
API | 修改好友备注名称 |
---|---|
uri | /openwx/set_friend_markname |
请求方法 | GET|POST |
请求参数 | id: 好友的id account: 好友的帐号 displayname: 好友当前显示名称 markname: 好友当前备注名称 new_markname:设置的新备注名称 (参数中包含中文需要做urlencode) |
数据格式 | application/x-www-form-urlencoded |
调用示例 | http://127.0.0.1:3000/openwx/set_friend_markname?id=xxxxxx&new_markname=xxxx |
返回JSON结果: |
{
"status":"success",
"code":0 #成功状态码为0,失败为非0
}
API | 设置群组的显示名称 |
---|---|
uri | /openwx/set_group_displayname |
请求方法 | GET|POST |
请求参数 | id: 群组的id displayname: 群组当前显示名称 new_displayname:设置的新显示名称 (参数中包含中文需要做urlencode) |
数据格式 | application/x-www-form-urlencoded |
调用示例 | http://127.0.0.1:3000/openwx/set_group_displayname?id=xxxxxx&new_displayname=xxxx |
返回JSON结果: |
{
"status":"success",
"code":0 #成功状态码为0,失败为非0
}
API | 向指定的群成员发送好友请求 |
---|---|
uri | /openwx/make_friend |
请求方法 | GET|POST |
请求参数 | id: 群成员的id verify:好友请求的附加信息 (参数中包含中文需要做urlencode) |
数据格式 | application/x-www-form-urlencoded |
调用示例 | http://127.0.0.1:3000/openwx/make_friend?id=xxxxxx&verify=hello |
返回JSON结果: |
{
"status":"success",
"code":0 #成功状态码为0,失败为非0
}