🔗 友情链接登记

需包含 http:// 或 https://
用于审核联系，不公开显示

获取友情链接列表

GET /api/links
获取已审核通过的友情链接列表
查询参数：
• category - 按分类筛选（逗号分隔多个分类，如：技术,博客）
• excludeCategory - 排除指定分类（逗号分隔，不返回这些分类的链接）
• exclude - 排除指定网站名称（逗号分隔）
• excludeId - 排除指定ID（逗号分隔）
• limit - 返回数量（默认100，最大500）
• offset - 分页偏移
curl "https://friendlink.xiaofei.icu/api/links?limit=10&category=技术"
curl "https://friendlink.xiaofei.icu/api/links?category=技术,博客,生活"
curl "https://friendlink.xiaofei.icu/api/links?excludeCategory=广告,推广"
fetch('https://friendlink.xiaofei.icu/api/links?limit=10')
  .then(res => res.json())
  .then(data => console.log(data));
fetch('https://friendlink.xiaofei.icu/api/links?category=技术,博客')
  .then(res => res.json())
  .then(data => console.log(data));
fetch('https://friendlink.xiaofei.icu/api/links?excludeCategory=广告,推广')
  .then(res => res.json())
  .then(data => console.log(data));
axios.get('https://friendlink.xiaofei.icu/api/links', {
  params: { limit: 10 }
})
.then(res => console.log(res.data));
axios.get('https://friendlink.xiaofei.icu/api/links', {
  params: { category: '技术,博客' }
})
.then(res => console.log(res.data));
axios.get('https://friendlink.xiaofei.icu/api/links', {
  params: { excludeCategory: '广告,推广' }
})
.then(res => console.log(res.data));
{
  "success": true,
  "data": {
    "list": [
      {
        "id": 1,
        "url": "https://example.com",
        "name": "示例网站",
        "author": "作者名",
        "category": "技术",
        "created_at": "2024-01-01T00:00:00.000Z"
      }
    ],
    "pagination": {
      "total": 50,
      "limit": 100,
      "offset": 0,
      "currentPage": 1,
      "totalPages": 1,
      "isFirstPage": true,
      "isLastPage": true,
      "hasNextPage": false,
      "hasPrevPage": false
    }
  }
}
响应字段说明：
• success - boolean 请求是否成功
• data.list - array 链接列表
• data.list[].id - number 链接ID
• data.list[].url - string 网站URL
• data.list[].name - string 网站名称
• data.list[].author - string 作者名称
• data.list[].category - string|null 分类名称
• data.list[].created_at - string 创建时间（ISO格式）
• data.pagination.total - number 总数
• data.pagination.limit - number 每页数量
• data.pagination.offset - number 当前偏移量
• data.pagination.currentPage - number 当前页码
• data.pagination.totalPages - number 总页数
• data.pagination.isFirstPage - boolean 是否为第一页
• data.pagination.isLastPage - boolean 是否为最后一页
• data.pagination.hasNextPage - boolean 是否有下一页
• data.pagination.hasPrevPage - boolean 是否有上一页
错误响应：
{
  "success": false,
  "message": "错误描述信息"
}

获取分类列表

GET /api/categories
获取所有网站分类
curl "https://friendlink.xiaofei.icu/api/categories"
fetch('https://friendlink.xiaofei.icu/api/categories')
  .then(res => res.json())
  .then(data => console.log(data));
axios.get('https://friendlink.xiaofei.icu/api/categories')
  .then(res => console.log(res.data));
{
  "success": true,
  "data": [
    { "id": 1, "name": "技术" },
    { "id": 2, "name": "博客" }
  ]
}
响应字段说明：
• success - boolean 请求是否成功
• data - array 分类列表
• data[].id - number 分类ID
• data[].name - string 分类名称
错误响应：
{
  "success": false,
  "message": "错误描述信息"
}
⚠️ 说明
以上两个接口支持跨域调用，可用于在其他网站展示友情链接。
其他接口（提交、管理等）仅限本站使用，不支持跨域。