# OpenAPI 接口 - 客户管理 - 分页列表查询

> 模块标识：openapi  |  接口数量：66

## 接口说明
**方法**：	GET

**路径**：				/openapi/customers/list

**功能说明**：
分页查询客户管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。

### 请求参数
```json
{
  "headers": [
    {
      "name": "X-Site",
      "type": "string",
      "required": true,
      "description": "站点标识（必填）"
    },
    {
      "name": "X-System-Code",
      "type": "string",
      "required": true,
      "description": "系统编码（必填）"
    }
  ],
  "query": [
    {
      "name": "pageNum",
      "type": "number",
      "required": false,
      "description": "页码，默认1"
    },
    {
      "name": "pageSize",
      "type": "number",
      "required": false,
      "description": "每页数量，默认10"
    },
    {
      "name": "name",
      "type": "string",
      "required": false,
      "description": "名称（模糊搜索）"
    },
    {
      "name": "code",
      "type": "string",
      "required": false,
      "description": "编码（模糊搜索）"
    }
  ]
}
```

### 响应示例
```json
{
  "success": {
    "code": "0000",
    "message": "查询成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "CUST0001",
          "name": "客户A",
          "title": "客户A公司",
          "phone": "13600136000",
          "email": "customer@example.com",
          "address": "北京市朝阳区",
          "status": 1,
          "createTime": "2025-01-01T10:00:00.000Z",
          "updateTime": "2025-01-01T10:00:00.000Z"
        }
      ],
      "total": 1,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}
```

### 注意事项
- 只返回状态为有效的记录（status=1）
- 支持多种可选查询条件进行筛选
- 必须提供有效的X-Site header，查询对应站点的数据
- 必须提供有效的X-System-Code header，支持客户端系统