公司管理

公司列表

GET /api/open/v1/companies

权限：open:company:read

查询参数：

参数	类型	必填	说明
page	int	否	页码，默认 1
page_size	int	否	每页条数，默认 20
keyword	string	否	搜索关键词（公司名称）
status	string	否	状态：frozen / active / pending / rejected
city	string	否	按城市筛选

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            {
                "id": 5,
                "name": "上海红娘婚介",
                "contact_name": "王经理",
                "contact_phone": "13100005678",
                "province": "上海",
                "city": "上海",
                "district": "浦东新区",
                "address": "浦东新区张江路 100 号",
                "logo_url": "https://oss.ailian.com/logo/5.png",
                "company_type": "normal",
                "cert_level": "gold",
                "status": "active",
                "created_at": "2025-01-10 08:00:00"
            }
        ],
        "total": 18
    }
}

---

公司详情

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

权限：open:company:read

路径参数：

参数	类型	说明
id	int	公司 ID

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 5,
        "name": "上海红娘婚介",
        "contact_name": "王经理",
        "contact_phone": "13100005678",
        "province": "上海",
        "city": "上海",
        "district": "浦东新区",
        "address": "浦东新区张江路 100 号",
        "logo_url": "https://oss.ailian.com/logo/5.png",
        "company_type": "normal",
        "cert_level": "gold",
        "status": "active",
        "created_at": "2025-01-10 08:00:00",
        "updated_at": "2025-06-01 12:00:00"
    }
}

---

创建公司

POST /api/open/v1/companies

权限：open:company:manage

请求体：

字段	类型	必填	说明
name	string	是	公司名称，2-100 字符
contact_name	string	否	联系人姓名
contact_phone	string	否	联系人电话
province	string	否	所在省份
city	string	否	所在城市
district	string	否	所在区县
address	string	否	公司地址
credit_code	string	否	统一社会信用代码
logo_url	string	否	Logo URL
company_type	string	否	公司类型：normal / franchisee

请求示例：

{
    "name": "北京心动婚介",
    "contact_name": "张总",
    "contact_phone": "13900001234",
    "province": "北京",
    "city": "北京",
    "district": "朝阳区",
    "address": "朝阳区建国路 88 号",
    "company_type": "normal"
}

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 19,
        "name": "北京心动婚介",
        "contact_name": "张总",
        "contact_phone": "13900001234",
        "province": "北京",
        "city": "北京",
        "district": "朝阳区",
        "address": "朝阳区建国路 88 号",
        "company_type": "normal",
        "status": "active",
        "created_at": "2025-08-07 14:00:00"
    }
}

---

修改公司

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

权限：open:company:manage

路径参数：

参数	类型	说明
id	int	公司 ID

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

请求示例：

{
    "contact_phone": "13900005678",
    "address": "朝阳区建国路 100 号"
}

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 19,
        "name": "北京心动婚介",
        "contact_phone": "13900005678",
        "address": "朝阳区建国路 100 号",
        "updated_at": "2025-08-07 15:00:00"
    }
}