红娘管理

红娘列表

GET /api/open/v1/matchmakers

权限：open:matchmaker:read

查询参数：

参数	类型	必填	说明
page	int	否	页码，默认 1
page_size	int	否	每页条数，默认 20，最大 500
company_id	int	否	按公司筛选
keyword	string	否	搜索关键词（姓名/手机号/微信号）
status	string	否	状态：`active` / `disabled`
level	string	否	等级：`normal` / `silver` / `gold`
work_wechat_id	int	否	按工作微信号 ID 过滤（触达的红娘）
group_nos	string[]	否	按微信侧群号过滤，可传多个
work_wechat_scope	string	否	触达范围：`all`（直连∪群内，默认）/ `direct`（仅直连）/ `group`（仅群内）
work_wechat_filter	string	否	工作微信号状态：`empty`（未关联）/ `has`（已关联）
has_guests	bool	否	按是否有嘉宾过滤：`true`（有嘉宾）/ `false`（无嘉宾）

响应示例：

json

{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            {
                "id": 12,
                "company_id": 5,
                "store_id": 3,
                "name": "王红娘",
                "phone": "13800001234",
                "wechat": "wang_hongniang",
                "wechat_id": "wxid_abc123",
                "country": "中国",
                "province": "广东省",
                "city": "深圳市",
                "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
    }
}

红娘 ID 列表

GET /api/open/v1/matchmakers/ids

权限：open:matchmaker:read

仅返回有微信 ID 的红娘，字段包含 id、wechat_id、group_nos（所在微信群的群号列表）和 work_wechat_ids（关联的工作微信号 ID 列表）。

支持按工作微信号触达范围过滤。

查询参数：

参数	类型	必填	说明
page	int	否	页码，默认 1
page_size	int	否	每页条数，默认 10000，最大 10000
company_id	int	否	按公司筛选
work_wechat_id	int	否	按工作微信号 ID 过滤（触达的红娘）
group_nos	string[]	否	按微信侧群号过滤，可传多个
work_wechat_scope	string	否	触达范围：`all`（直连∪群内，默认）/ `direct`（仅直连）/ `group`（仅群内）

响应示例：

json

{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            { "id": 12, "wechat_id": "wxid_abc123", "group_nos": ["1001", "1002"], "work_wechat_ids": [10, 11] },
            { "id": 13, "wechat_id": "wxid_xyz789", "group_nos": [], "work_wechat_ids": [] }
        ],
        "total": 2
    }
}

红娘详情

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

权限：open:matchmaker:read

路径参数：

参数	类型	说明
id	int	红娘 ID

响应示例：

json

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 12,
        "company_id": 5,
        "store_id": 3,
        "name": "王红娘",
        "phone": "13800001234",
        "wechat": "wang_hongniang",
        "wechat_id": "wxid_abc123",
        "country": "中国",
        "province": "广东省",
        "city": "深圳市",
        "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

请求体：

字段	类型	必填	说明
name	string	是	姓名，1-50 字符
company_id	int	否	所属公司 ID，独立红娘可不填
store_id	int	否	所属门店 ID
phone	string	否	手机号
wechat	string	否	微信号
wechat_id	string	否	微信 ID
country	string	否	国家
province	string	否	省份
city	string	否	城市
avatar	string	否	头像 URL
years_exp	int	否	从业年限
specialty	string	否	擅长领域，最长 200 字符
intro	string	否	个人简介，最长 500 字符
level	string	否	等级：`normal`（默认）/ `silver` / `gold`

请求示例：

json

{
    "name": "李红娘",
    "company_id": 5,
    "phone": "13900139001",
    "wechat": "li_hongniang",
    "wechat_id": "wxid_xyz789",
    "country": "中国",
    "province": "广东省",
    "city": "广州市",
    "years_exp": 3,
    "specialty": "中青年匹配",
    "intro": "从业3年，擅长中青年群体匹配服务",
    "level": "silver"
}

响应示例：

json

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 13,
        "company_id": 5,
        "name": "李红娘",
        "phone": "13900139001",
        "wechat": "li_hongniang",
        "wechat_id": "wxid_xyz789",
        "country": "中国",
        "province": "广东省",
        "city": "广州市",
        "years_exp": 3,
        "specialty": "中青年匹配",
        "intro": "从业3年，擅长中青年群体匹配服务",
        "level": "silver",
        "guest_count": 0,
        "match_count": 0,
        "success_rate": 0,
        "credit_score": 100,
        "status": "active",
        "created_at": "2025-08-07 10:00:00"
    }
}

修改红娘

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

权限：open:matchmaker:manage

路径参数：

参数	类型	说明
id	int	红娘 ID

请求体：所有字段均为可选，仅传入需要更新的字段。字段说明与创建接口一致。

请求示例：

json

{
    "phone": "13900139002",
    "specialty": "高端客户匹配",
    "level": "gold"
}

响应示例：

json

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 13,
        "company_id": 5,
        "name": "李红娘",
        "phone": "13900139002",
        "specialty": "高端客户匹配",
        "level": "gold",
        "updated_at": "2025-08-07 11:00:00"
    }
}

红娘管理 ​

红娘列表 ​

红娘 ID 列表 ​

红娘详情 ​

创建红娘 ​

修改红娘 ​

红娘管理

红娘列表

红娘 ID 列表

红娘详情

创建红娘

修改红娘