# 好友列表 * **说明** > 查询用户的所有好友信息。该接口返回用户的所有好友，包括等待验证的好友和已经添加的好友。 * **URL**：/v1/user/friend/list * **请求方式**：GET * **Header参数**： | **Header\_Key** | **Header\_Value** | | :---: | :---: | | **ts** | 精确到ms的时间戳 | | **openid** | openid，每个个人用户的唯一标识 | | **applicationid** | 应用ID，每个开发者的唯一标识 | | **sign** | 加密签名，算法为SHA1\(HTTPMethod+RequestURI+params+applicationkey\) | * **返回内容** **成功时：** > 返回内容 ``` { "code":0, "data":[ { "uid":"", "status":"", "auth":"", "nickname":"", "createTime":"", "authTime":"", "friendName":"" }, …… ] } ``` > 返回说明 | **参数名称** | **中文名称** | **类型** | **说明** | | :--- | :--- | :--- | :--- | | **uid** | 用户ID | 字符串 | 好友的id信息 | | **status** | 好友状态 | 整型 | 好友状态信息，0：等待对方验证；1：对方要加自己为好友，等待验证；2：成功成为好友 | | **auth** | 权限 | 整型 | 0不允许1允许 | | **nickname** | 昵称 | 字符串 | 昵称 | | **createTime** | 创建时间 | 字符串 | 好友创建时间 | | **authTime** | 加权限时间 | 字符串 | 加权限时间 | | **friendName** | 名称 | 字符串 | 好友名称 | **失败时：** ``` { "code": ERRORCODE //ERRORCODE可以去错误码目录中查找 } ```