好友请求

查询好友请求

接口说明

查询收到或发出的好友申请列表。

请求信息

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

请求参数

参数名	类型	必填	说明
type	string	否	查询类型：received（默认）= 收到的申请；sent = 发出的申请

请求示例

curl -X GET "https://devapi.fengshengshou.com/api/friends/requests?type=received" \
  -H "Authorization: Bearer your_token_here"

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	响应描述
data	array	好友请求数组
data[].id	int	好友关系 ID
data[].user	object	申请方用户信息
data[].user.id	int	用户 ID
data[].user.name	string	用户姓名
data[].user.avatar	string	用户头像 URL
data[].user.department	string	用户所在部门名称
data[].message	string	申请附言
data[].status	int	申请状态
data[].created_at	string	申请时间，格式 Y-m-d H:i:s

成功响应

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "id": 301,
      "user": {
        "id": 105,
        "name": "赵七",
        "avatar": "https://devapi.fengshengshou.com/uploads/avatars/105.jpg",
        "department": "研发部"
      },
      "message": "你好，希望加你为好友！",
      "status": 0,
      "created_at": "2026-07-04 10:20:00"
    },
    {
      "id": 302,
      "user": {
        "id": 106,
        "name": "孙八",
        "avatar": "https://devapi.fengshengshou.com/uploads/avatars/106.jpg",
        "department": "财务部"
      },
      "message": "",
      "status": 0,
      "created_at": "2026-07-05 08:00:00"
    }
  ]
}

失败响应

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

---

处理好友请求

接口说明

接受或拒绝收到的好友申请。

请求信息

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

请求参数

路径参数：

参数名	类型	必填	说明
id	int	是	好友关系 ID（路径参数）

请求体参数：

参数名	类型	必填	说明
action	string	是	操作类型，取值 accept（接受）或 reject（拒绝）

请求示例

curl -X POST "https://devapi.fengshengshou.com/api/friends/requests/301/handle" \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "accept"
  }'

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	响应描述
data	null	成功时固定为 null

成功响应

{
  "code": 0,
  "message": "操作成功",
  "data": null
}

失败响应

{
  "code": 422,
  "message": "action 字段值无效，必须为 accept 或 reject",
  "data": null
}