GEWE框架友情链接:geweapi.com 点击访问即可。
联系人/群列表
小提示:
- 注意群需要保存通讯录才会显示
请求URL:
- http://域名地址/api/contacts/listings
请求方式:
- POST
请求头:
-
Content-Type:application/json
-
X-GEWE-TOKEN: 后台获取
参数:
参数名 | 必填 | 数据类型 | 说明 |
---|---|---|---|
appid | 是 | string | 设备id |
current_chat_room_contact_seq | 是 | number | 默认首次传0,之后传上次返回的current_chat_room_contact_seq |
current_wxcontact_seq | 是 | number | 默认首次传0,之后传上次返回的current_wxcontact_seq |
返回数据:
参数名 | 数据类型 | 说明 |
---|---|---|
ret | number | 0:成功 |
msg | string | 反馈信息 |
data | object | |
data.ContactUsernameList | object | 联系人信息列表(gh开头代表公众号 chatroom结尾代表群聊,其余为联系人) |
请求参数示例:
{
"appid": "wx_nScLwnZhfNmlQlL0npc71",
"current_chat_room_contact_seq": 0,
"current_wxcontact_seq": 802070105
}
成功返回示例:
{
"ret": 0,
"msg": "success",
"data": {
"BaseResponse": {
"ret": 0,
"errMsg": {
"string": ""
}
},
"CurrentWxcontactSeq": 706991681,
"CurrentChatRoomContactSeq": 706988914,
"CountinueFlag": 0,
"ContactUsernameList": [
"gh_3dfda90e39d6",
"wxid_oh1x6dthgu4h22",
"weixinhao",
"47482870178@chatroom"
]
}
}
错误返回示例:
{
"ret": -1,
"msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]设备不存在或已离线"
}
联系人关系检测
小提示:
- 查询与某位联系的关系是否正常
- 注意每次最多查询20位联系人
请求URL:
- http://域名地址/api/contacts/check
请求方式:
- POST
请求头:
-
Content-Type:application/json
-
X-GEWE-TOKEN: 后台获取
参数:
参数名 | 必填 | 数据类型 | 说明 |
---|---|---|---|
appid | 是 | string | 设备id |
to_wxid_list | 是 | array | 用户wxid |
返回数据:
参数名 | 数据类型 | 说明 |
---|---|---|
ret | number | 0:成功 |
msg | string | 反馈信息 |
data | object |
请求参数示例:
{
"appid": "wx_nScLwnZhfNmlQlL0npc71",
"to_wxid_list": [
"wxid_4bxxxxxxxxxxx22"
]
}
成功返回示例:
{
"ret": 0,
"msg": "success",
"data": {
"result": [
{
"to_wxid": "wxid_4bxxxxxxxxxxx22",
"state": "正常关系"
}
]
}
}
错误返回示例:
{
"ret": -1,
"msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]设备不存在或已离线"
}
删除联系人
小提示:
- 删除掉某个联系人
- 注意每天删除联系人有限制
请求URL:
- http://域名地址/api/contacts/delete
请求方式:
- POST
请求头:
-
Content-Type:application/json
-
X-GEWE-TOKEN: 后台获取
参数:
参数名 | 必填 | 数据类型 | 说明 |
---|---|---|---|
appid | 是 | string | 设备id |
to_wxid | 是 | string | 用户wxid |
返回数据:
参数名 | 数据类型 | 说明 |
---|---|---|
ret | number | 0:成功 |
msg | string | 反馈信息 |
data | object |
请求参数示例:
{
"appid": "wx_nScLwnZhfNmlQlL0npc71",
"to_wxid": "wxid_4bxxxxxxxxxxx22",
}
成功返回示例:
{
"ret": 0,
"msg": "success",
"data": {
"ret": 0,
"oplogRet": {
"count": 1,
"ret": "AA=="
}
}
}
错误返回示例:
{
"ret": -1,
"msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]设备不存在或已离线"
}