GEWE框架官方网站 geweapi.com 点击访问即可
搜索
小提示:
- 添加联系人必要接口
- 搜索返回的V3 V4用于添加联系人
请求URL:
- http://域名地址/api/contacts/search
请求方式:
- POST
请求头:
-
Content-Type:application/json
-
X-GEWE-TOKEN: 后台获取
参数:
参数名 | 必填 | 数据类型 | 说明 |
---|---|---|---|
appid | 是 | string | 设备id |
user_name | 是 | string | 搜索的手机号/微信号 |
返回数据:
参数名 | 数据类型 | 说明 |
---|---|---|
ret | number | 0:成功 |
msg | string | 反馈信息 |
data | object | |
data.UserName | object | 用户名 添加好友凭证1 (如果是好友返回id 非好友是凭证) |
data.NickName | object | 用户昵称 |
data.Province | string | 省份 |
data.City | string | 市区 |
data.Country | string | 国家 |
data.Signature | string | 个性签名 |
data.Sex | string | 性别 1、男 2、女 |
data.BigHeadImgUrl | string | 大头像 |
data.SmallHeadImgUrl | string | 小头像 |
data.AntispamTicket | string | 添加好友凭证2 |
请求参数示例:
{"appid": "wx_nScLwnZhfNmlQlL0npc71","user_name": "18761670817",}
成功返回示例:
{"ret": 0,"msg": "success","data": {"BaseResponse": {"ret": 0,"errMsg": {"string": "Everything is OK"}},"UserName": {"string": "v3_020b3826f。。。。。。"},"NickName": {"string": "张三"},"Pyinitial": {"string": "wxid_bo6akbwms8rv12"},"QuanPin": {"string": "wxid_bo6akbwms8rv12"},"Sex": 2,"ImgBuf": {"iLen": 0},"Province": "Anhui","City": "MOS","Signature": "默默无闻。。","PersonalCard": 1,"VerifyFlag": 0,"WeiboFlag": 0,"AlbumStyle": 0,"AlbumFlag": 3,"SnsUserInfo": {"SnsFlag": 0,"SnsBgobjectId": 0,"SnsFlagEx": 0},"Country": "CN","MyBrandList": "<brandlist count=\"0\" ver=\"841173559\"></brandlist>","CustomizedInfo": {"BrandFlag": 0},"ContactCount": 0,"BigHeadImgUrl": "http://123456","SmallHeadImgUrl": "http://456789","ResBuf": {"iLen": 0},"AntispamTicket": "v4_000b708f0b040。。。。。。。。","MatchType": 2}
}
- 如果是好友 UserName字段显示的是id AntispamTicket为空
非好友的情况 可以根据 UserName以及 AntispamTicket 作为添加好友的凭证
错误返回示例:
{"ret": -1,"msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]设备不存在或已离线"}
好友请求验证
小提示:
- v_3 v_4 可以参考 搜索接口
请求URL:
- http://域名地址/api/contacts/verifyuser
请求方式:
- POST
请求头:
-
Content-Type:application/json
-
X-GEWE-TOKEN: 后台获取
参数:
参数名 | 必填 | 数据类型 | 说明 |
---|---|---|---|
appid | 是 | string | 设备id |
config | 否 | object | 其他配置 |
config.card_nickname | 否 | string | 昵称 |
config.card_username | 否 | string | 用户id |
config.group_id | 否 | string | 群id 如果是群加好友 必填 |
content | 否 | string | 申请语 |
opcode | 是 | number | 2添加好友 3同意好友 4拒绝好友 |
scene | 是 | number | 添加方式 3 :微信号搜索 4 :QQ好友 8 :来自群聊 15:手机号 |
v_3 | 是 | string | 添加好友凭证1 |
v_4 | 是 | string | 添加好友凭证2 |
返回数据:
参数名 | 数据类型 | 说明 |
---|---|---|
ret | number | 0:成功 |
msg | string | 反馈信息 |
请求参数示例:
{"appid": "wx_nScLwnZhfNmlQlL0npc71","config": {"card_nickname": "","card_username": "","group_id": ""},"content": "","opcode": 0,"scene": 3,"v_3": "v3_0000000sdasda.......","v_4": "v4_13910381083........"}
成功返回示例:
{"ret": 0,"msg": "success","data": {"BaseResponse": {"ret": 0,"errMsg": {}}}}
错误返回示例:
{"ret": 0,"msg": "success","data": {"BaseResponse": {"ret": -2,"errMsg": {"string": "Invalid argument"}}}
}