GEWE框架官方网站 geweapi.com 点击访问即可
搜索
小提示:
- 添加联系人必要接口
- 搜索返回的V3 V4用于添加联系人
请求URL:
请求方式:
- 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:
请求方式:
- 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"
}
}
}
}