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"}}}
}