ai-c/docs/interest_partner_api.md

兴趣搭子页面 API 接口文档

1. 获取页面素材 (Banner)

用于获取兴趣搭子页面的顶部 Banner 图片。

接口地址: GET /api/page-assets

请求参数:

参数名	类型	必填	说明
group	string	是	固定值: interest_partner

响应示例:

{
  "success": true,
  "code": 0,
  "data": {
    "banners": [
      "/uploads/images/banner1.jpg",
      "/uploads/images/banner2.jpg"
    ],
    "banner": "/uploads/images/banner1.jpg, /uploads/images/banner2.jpg" 
  },
  "message": "success"
}

字段说明:

• 优先读取 banners 数组字段。
• 如果 banners 不存在，则尝试读取 banner、interest_banner、top_banner 字段。
• 支持单字符串字段包含逗号分隔的多张图片 URL（如 "url1, url2"），前端会自动分割。
• 支持完整 URL (https://...) 或相对路径 (/uploads/...)。

---

2. 获取兴趣搭子列表 (现有)

接口地址: GET /api/interest-partners

请求参数:

参数名	类型	必填	说明
page	number	否	页码，默认 1
limit	number	否	每页数量
city	string	否	城市筛选
category_id	number	否	分类ID

响应示例:

{
  "success": true,
  "data": {
    "list": [
      {
        "id": 1,
        "name": "美食聚餐",
        "description": "同城美食 共享美味",
        "icon": "/images/icon-food.png",
        "bg_color": "#FFF7ED",
        "icon_color": "#FF7A45",
        "member_count": "500+",
        "qr_code": "/images/qr-food.jpg",
        "group_name": "美食聚餐群",
        "group_description": "加入我们一起寻找城市美味"
      }
    ]
  }
}