查询客户名单列表（QueryCustomerManagementList）

前提条件

• 已安装SDK。

• 已获取并使用AccessKey的方式，请参考获取AccessKey并配置到环境变量。

请求参数

响应参数

使用示例

import json
import os
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_tea_openapi.client import Client as OpenApiClient
from alibabacloud_tea_util import models as util_models
from alibabacloud_openapi_util.client import Client as OpenApiUtilClient


def main():
    config = open_api_models.Config(
        access_key_id=os.getenv("ACCESS_KEY_ID"),
        access_key_secret=os.getenv("ACCESS_KEY_SECRET"),
    )
    config.endpoint = "thirdswaicall.aliyuncs.com"
    config.protocol = "HTTPS"
    client = OpenApiClient(config)

    params = open_api_models.Params(
        style="RPC",
        version="2025-11-27",
        action="QueryCustomerManagementList",
        method="POST",
        pathname="/",
        protocol="HTTPS",
        auth_type="AK",
        req_body_type="json",
        body_type="json",
    )

    body = {'Current': 1, 'Size': 10}
    # body['CustomerListName'] = 'VIP客户'  # 可选

    request = open_api_models.OpenApiRequest(query=OpenApiUtilClient.query(body))
    runtime = util_models.RuntimeOptions(autoretry=True, max_attempts=3)
    try:
        resp = client.call_api(params, request, runtime)
        print(json.dumps(resp.get("body", {}), ensure_ascii=False, indent=2))
    except Exception as e:
        print(f"调用失败: {e}")


if __name__ == "__main__":
    main()

import com.aliyun.teaopenapi.Client;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teaopenapi.models.OpenApiRequest;
import com.aliyun.teaopenapi.models.Params;
import com.aliyun.teautil.models.RuntimeOptions;
import com.google.gson.Gson;

import java.util.HashMap;
import java.util.Map;

public class Demo {
    public static void main(String[] args) throws Exception {
        // 初始化配置
        Config config = new Config()
            .setAccessKeyId(System.getenv("ACCESS_KEY_ID"))
            .setAccessKeySecret(System.getenv("ACCESS_KEY_SECRET"))
            .setEndpoint("thirdswaicall.aliyuncs.com")
            .setProtocol("HTTPS");

        Client client = new Client(config);

        // 设置 API 参数
        Params params = new Params()
            .setStyle("RPC")
            .setVersion("2025-11-27")
            .setAction("QueryCustomerManagementList")
            .setMethod("POST")
            .setPathname("/")
            .setProtocol("HTTPS")
            .setAuthType("AK")
            .setReqBodyType("json")
            .setBodyType("json");

        // 构建请求参数
        Map<String, Object> body = new HashMap<>();
        body.put("Current", 1);
        body.put("Size", 10);
        // body.put("CustomerListName", "VIP客户");  // 可选

        OpenApiRequest request = new OpenApiRequest()
            .setQuery(com.aliyun.openapiutil.Client.query(body));

        // 设置运行时选项（自动重试）
        RuntimeOptions runtime = new RuntimeOptions()
            .setAutoretry(true)
            .setMaxAttempts(3);

        try {
            // 调用 API
            Map<String, ?> response = client.callApi(params, request, runtime);
            Gson gson = new Gson();
            System.out.println(gson.toJson(response.get("body")));
        } catch (Exception e) {
            System.err.println("调用失败: " + e.getMessage());
        }
    }
}

返回示例

{
  "Success": true,
  "Code": "SUCCESS",
  "Message": "操作成功",
  "RequestId": "xxxx-xxxx-xxxx",
  "Total": 2,
  "Current": 1,
  "Size": 10,
  "Records": [
    {
      "Id": 1001,
      "CustomerListName": "VIP客户名单",
      "CustomerListCount": 500,
      "IsUsed": "1",
      "GmtCreate": "2025-12-01 10:00:00",
      "GmtModified": "2025-12-01 10:05:00"
    },
    {
      "Id": 1002,
      "CustomerListName": "春节促销名单",
      "CustomerListCount": 1200,
      "IsUsed": "0",
      "GmtCreate": "2025-12-15 14:30:00",
      "GmtModified": "2025-12-15 14:30:00"
    }
  ]
}

具体的处理结果在Records节点中，以下为Records节点的参数说明。

错误信息

如果执行报错，请参考错误信息进行解决。