公司/租户管理

公司列表

GET /api/open/v1/companies

权限：open:company:read

查询参数：

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

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            {
                "id": 5,
                "name": "上海红娘婚介",
                "contact_name": "王经理",
                "contact_phone": "13100005678",
                "province": "上海",
                "city": "上海",
                "address": "浦东新区张江路 100 号",
                "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 号",
        "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 号"
}

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 10,
        "name": "北京缘分红娘",
        "contact_name": "张经理",
        "contact_phone": "13900001234",
        "province": "北京",
        "city": "北京",
        "district": "朝阳区",
        "address": "朝阳区建国路 88 号",
        "status": "active",
        "created_at": "2026-08-06 17:00:00"
    }
}

---

修改公司

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

权限：open:company:manage

路径参数：

参数	类型	说明
id	int	公司 ID

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

参数	类型	说明
name	string	公司名称
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	公司类型

请求示例：

{
    "contact_phone": "13800005678",
    "address": "朝阳区建国路 99 号"
}

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 10,
        "name": "北京缘分红娘",
        "contact_name": "张经理",
        "contact_phone": "13800005678",
        "province": "北京",
        "city": "北京",
        "district": "朝阳区",
        "address": "朝阳区建国路 99 号",
        "status": "active",
        "created_at": "2026-08-06 17:00:00",
        "updated_at": "2026-08-06 17:30:00"
    }
}