搜索好友
# 搜索好友
**简要描述**:
- 搜索联系人,可用于爆粉搜索;根据 支持手机号/微信号搜索
**请求URL**
- {APIURL}/wc/friend/search
**请求方式**
- POST
**请求头Headers**
- Content-Type:application/json
- Access-Token:login接口返回
**参数**
|参数名|必选|类型|说明
|-|-|-|-|
|wcid|是|string|微信实例ID
|user|是|string|支持微信号、手机号
|from_scene|是|int| 填写0
|search_scene|是|int|填写1
**返回数据**:
|参数名|类型|说明|
|-|-|-|
|code|string|0成功,-1失败|
|msg|string|反馈信息|
|data|jsonobject||
|userName|string|添加好友凭证1(如果是好友 会返回wxid);唯一不变值好友添加成功后回调会返会此值|
|antispamTicket|string|添加好友凭证2,如果是好友 则为空|
|nickName|string|昵称|
|bigHeadImgUrl|string|大头像|
|smallHeadImgUrl|string|小头像|
**请求参数示例**
```
{
"wcid": 1396125131209707520,
"user": "180********",
"from_scene":0,
"search_scene:1
}
```
**成功返回示例**
- 非好友返回数据
```
{
"code": 0,
"msg": "success",
"data": {
"nickName": "薇薇",
"sex": 2,
"userName": "v1_90c13d2bb0ff6bb85db28341af32ec2cc80194eac15c3ab6534d28c127a2270e802c06bba0a41a904423a01855870756@stranger",
"wxid": "v1_90c13d2bb0ff6bb85db28041a562ec2cc80194eac15c3ab6534d28c127a2270e802c06bba0a41a904423a01855870756@stranger",
"antispamTicket": "v4_000b708f0b040000010000000033b1bda847bd5ff86a7d236cdee25e1000000050ded0b020927e3c97896a09d47e6e9e387eb23497cde91ca8c3d17dc5cfb3703eb5c81a9b0c457a9cafb398238b24ad0c0e060c43c6bd464ca15269a601c3dffa3da32a659c32e7e58eeee0b9ec7873c5a4828ce51992d917@stranger",
"bigHead": "http://wx.qlogo.cn/mmhead/ver_1/R6ibiaIVLfEqxcDCCsOGN6ice3Z4pkLnYuV6M1VbYkicuCNATqBk3x2aDmx5uS0iaTvtrDWJlnSaPUwEexPTI67m3fRK4DvIHWIbe85bILNWPhC4/0",
"smallHead": "http://wx.qlogo.cn/mmhead/ver_1/R6ibiaIVLfEqxcDCCsOGN6ice3Z4pkLnYuV6M1VbYkicuCNATqBk3x2aDmx5uS0iaTvtrDWJlnSaPUwEexPTI67m3fRK4DvIHWIbe85bILNWPhC4/132"
}
}
```
- 是好友返回数据
```
{
"code": 0,
"data": {
"userName": "wxid_0008590085622",
"antispamTicket": "",
"nickName": "Rose",
"smallHeadImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/AfCkWm8up89nPEibeeWsbBic8Ff4jiaLhSxXGztib4yP70YhXqxTx2ds95XibO48ZMT2kxSyAGUiaFcJcmE7HVrM9T94snkuGrSic8SxoSL88gjvrA/132",
"bigHeadImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/AfCkWm8up89nPEibeeWsbBic8Ff4jiaLhSxXGztib4yP70YhXqxTx2ds95XibO48ZMT2kxSyAGUiaFcJcmE7HVrM9T94snkuGrSic8SxoSL88gjvrA/0",
"sex": 2,
"signature": "",
"province": "",
"city": "",
"country": "",
"personalCard": 0,
"wxid": "wxid_0008590085622"
},
"msg": "success"
}
```
**错误返回示例**
```
{
"msg": "失败",
"code": -1,
"data": null
}
```