好友列表

接口说明

获取当前登录用户的全部好友列表。

请求信息

项目	内容
请求方式	GET
接口地址	https://devapi.fengshengshou.com/api/friends
鉴权	是，需在请求头中携带 Token

请求参数

本接口无请求参数。

请求示例

curl -X GET "https://devapi.fengshengshou.com/api/friends" \
  -H "Authorization: Bearer your_token_here"

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	响应描述
data	array	好友数组
data[].id	int	好友关系 ID
data[].friend_id	int	好友的用户 ID
data[].name	string	好友姓名
data[].avatar	string	好友头像 URL
data[].remark	string	备注名（别名），未设置时为空字符串
data[].department	string	好友所在部门名称
data[].status	int	好友关系状态，1 表示已通过
data[].online_status	int	在线状态
data[].created_at	string	成为好友时间，格式 Y-m-d H:i:s

成功响应

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "id": 201,
      "friend_id": 102,
      "name": "李四",
      "avatar": "https://devapi.fengshengshou.com/uploads/avatars/102.jpg",
      "remark": "小李",
      "department": "技术部",
      "status": 1,
      "online_status": 1,
      "created_at": "2026-01-15 09:30:00"
    },
    {
      "id": 202,
      "friend_id": 103,
      "name": "王五",
      "avatar": "https://devapi.fengshengshou.com/uploads/avatars/103.jpg",
      "remark": "",
      "department": "市场部",
      "status": 1,
      "online_status": 0,
      "created_at": "2026-02-20 14:00:00"
    }
  ]
}

失败响应

{
  "code": 401,
  "message": "未登录或 Token 已过期",
  "data": null
}