红娘管理

红娘列表

GET /api/open/v1/matchmakers

权限：open:matchmaker:read

查询参数：

参数	类型	必填	说明
page	int	否	页码，默认 1
page_size	int	否	每页条数，默认 20
company_id	int	否	按公司筛选
keyword	string	否	搜索关键词（姓名/手机号）
status	string	否	状态：active / disabled
level	string	否	等级：normal / silver / gold

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            {
                "id": 12,
                "company_id": 5,
                "store_id": 3,
                "name": "王红娘",
                "phone": "13800001234",
                "wechat": "wang_hongniang",
                "avatar": "https://oss.ailian.com/avatar/12.jpg",
                "years_exp": 5,
                "specialty": "高端客户匹配",
                "intro": "从事婚恋行业5年，擅长高端客户匹配",
                "guest_count": 120,
                "match_count": 45,
                "success_rate": 85.5,
                "credit_score": 100,
                "level": "gold",
                "cert_level": "senior",
                "status": "active",
                "created_at": "2025-01-15 09:00:00"
            }
        ],
        "total": 12
    }
}

---

红娘详情

GET /api/open/v1/matchmakers/{id}

权限：open:matchmaker:read

路径参数：

参数	类型	说明
id	int	红娘 ID

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 12,
        "company_id": 5,
        "store_id": 3,
        "name": "王红娘",
        "phone": "13800001234",
        "wechat": "wang_hongniang",
        "avatar": "https://oss.ailian.com/avatar/12.jpg",
        "years_exp": 5,
        "specialty": "高端客户匹配",
        "intro": "从事婚恋行业5年，擅长高端客户匹配",
        "guest_count": 120,
        "match_count": 45,
        "success_rate": 85.5,
        "credit_score": 100,
        "level": "gold",
        "cert_level": "senior",
        "status": "active",
        "created_at": "2025-01-15 09:00:00"
    }
}

---

创建红娘

POST /api/open/v1/matchmakers

权限：open:matchmaker:manage

请求体：

参数	类型	必填	说明
company_id	int	否	所属公司 ID，独立红娘可不填
store_id	int	否	所属门店 ID
name	string	是	姓名（2-50字符）
phone	string	否	手机号
wechat	string	否	微信号
avatar	string	否	头像 URL
years_exp	int	否	从业年限
specialty	string	否	擅长领域
intro	string	否	个人简介
level	string	否	等级：normal / silver / gold，默认 normal

请求示例（公司红娘）：

{
    "company_id": 5,
    "name": "李红娘",
    "phone": "13900005678",
    "wechat": "li_hongniang",
    "years_exp": 3,
    "specialty": "年轻客户匹配",
    "level": "silver"
}

请求示例（独立红娘）：

{
    "name": "张红娘",
    "phone": "13700009999",
    "years_exp": 8,
    "specialty": "高端客户匹配"
}

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 15,
        "company_id": 5,
        "store_id": null,
        "name": "李红娘",
        "phone": "13900005678",
        "wechat": "li_hongniang",
        "avatar": null,
        "years_exp": 3,
        "specialty": "年轻客户匹配",
        "intro": null,
        "guest_count": 0,
        "match_count": 0,
        "success_rate": 0,
        "credit_score": 100,
        "level": "silver",
        "cert_level": null,
        "status": "active",
        "created_at": "2026-08-06 17:00:00"
    }
}

---

修改红娘

PUT /api/open/v1/matchmakers/{id}

权限：open:matchmaker:manage

路径参数：

参数	类型	说明
id	int	红娘 ID

请求体（所有字段可选，仅更新提供的字段）：

参数	类型	说明
store_id	int	所属门店 ID
name	string	姓名
phone	string	手机号
wechat	string	微信号
avatar	string	头像 URL
years_exp	int	从业年限
specialty	string	擅长领域
intro	string	个人简介
level	string	等级

请求示例：

{
    "phone": "13800009999",
    "specialty": "高端客户匹配，擅长沟通",
    "level": "gold"
}

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 15,
        "company_id": 5,
        "store_id": null,
        "name": "李红娘",
        "phone": "13800009999",
        "wechat": "li_hongniang",
        "avatar": null,
        "years_exp": 3,
        "specialty": "高端客户匹配，擅长沟通",
        "intro": null,
        "guest_count": 0,
        "match_count": 0,
        "success_rate": 0,
        "credit_score": 100,
        "level": "gold",
        "cert_level": null,
        "status": "active",
        "created_at": "2026-08-06 17:00:00",
        "updated_at": "2026-08-06 17:30:00"
    }
}