Skip to content

接口说明:获取所有友链

基本信息

  • 请求方式GET
  • 请求路径/friend
  • 功能描述:从数据库中获取所有友链信息,返回包含名称、链接和头像的完整列表。

请求参数

该接口 不需要 任何请求参数。

响应参数

成功响应 (200)

  • 说明:成功返回友链列表。
  • 返回格式application/json
  • 示例
json
[
  {
    "name": "Jerry",
    "link": "https://butterfly.js.org/",
    "avatar": "https://butterfly.js.org/img/avatar.png"
  },
  {
    "name": "Alice",
    "link": "https://alice.blog/",
    "avatar": "https://alice.blog/avatar.jpg"
  }
]

失败响应

404 未找到友链

  • 说明:数据库中不存在任何友链记录。
  • 示例
json
{
  "message": "not found"
}

500 服务器内部错误

  • 说明:服务器运行出错,例如数据库异常。
  • 示例
json
{
  "message": "server internal error"
}

使用说明

  • 该接口通常用于前端展示友链页面,获取所有合作博客或站点的信息。

  • 若数据库为空,将返回 404 not found

  • 返回结果中每个对象包含:

    • name:站点名称
    • link:站点链接
    • avatar:站点头像 URL