# 搜索好友 * **说明** > 根据好友的名字、手机号或者邮箱搜索好友。 * **URL**：/v1/user/friend/search * **请求方式**：POST * **Header参数**： | **Header\_Key** | **Header\_Value** | | :---: | :---: | | **ts** | 精确到ms的时间戳 | | **openid** | openid，每个个人用户的唯一标识 | | **applicationid** | 应用ID，每个开发者的唯一标识 | | **sign** | 加密签名，算法为SHA1\(HTTPMethod+RequestURI+params+applicationkey\) | * **请求内容**： | **参数名称** | **中文名称** | **类型** | **限制** | **必须** | **说明** | | :--- | :---: | :---: | :---: | :---: | :--- | | **key** | 搜索关键字 | 字符串 | 32 | 是 | 好友名字,手机号或email | * **返回内容** **成功时：** > 返回内容 ``` { "code":0, "data":[ { "uid":"", "email":"", "username":"", "telephone":"", "note":"" }, …… ] } ``` > 返回说明 | **参数名称** | **中文名称** | **类型** | **说明** | | :--- | :--- | :--- | :--- | | **uid** | 用户ID | 字符串 | 好友的id信息 | | **email** | 邮箱 | 字符串 | 邮箱 | | **username** | 用户名 | 字符串 | 用户名 | | **telephone** | 手机号 | 字符串 | 手机号 | | **note** | 备注 | 字符串 | 备注 | **失败时：** ``` { "code": ERRORCODE //ERRORCODE可以去错误码目录中查找 } ```