查询group下的客户端信息

最近更新时间: 2026-09-17 00:01:37

1. 接口描述

接口请求域名： dtf.api3.fincloud.tencent.cn。

查询group下的客户端信息

默认接口请求频率限制：200次/秒。

接口更新时间：2023-04-23 20:54:45。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：DescribeClients
Version 是 否 String 公共参数，本接口取值：2020-05-06
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
GroupId 是 否 String 事务分组ID
示例值：
ClusterId 是 否 String 集群名称
示例值：

3. 输出参数

参数名称 类型 描述
Result ClientList 客户端列表
示例值：查看
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

该接口暂无业务逻辑相关的错误码，其他错误码详见公共错误码。

5. 示例

示例1 示例57

输入示例

POST / HTTP/1.1
Host: tapi.fincloud.tencent.cn
Content-Type: application/json
X-TC-Action: DescribeClients
<公共请求参数>

{
    "Action": "DescribeClients",
    "AppId": 1255000475,
    "CamContext": "{\"clientIP\":\"182.140.153.39\",\"onlySignTag\":1,\"q-token\":\"1ddprBuFSbk1FqHxgSqgS7C9oMAnP269a199c82ce69a4294e41c0b72bf7e4ecc8168bba8febDktGehDDCKWceGzHiBCTcYpAkH55J82xBZQr8Nb3dOSFLBGBgSuGI21Vhj_gnxfBOS9PGX0PAB3XM8_9ywo2m_VC_l5NRFRBX_C1mtLdsYIaQfF5VlkcrVGoyY_InrpnkjyddSTG7AlHednVCq6LxrpmgQzGQ3MsjOaHbnYg7YlFBSVMu83pFq5gWFRsg9DLn7Z4m7dmK24GTETJgB5OWMXO1vVO_9ee0ZIM71YlE8yDKbsu2CPDVvLlP5XMz5p3Xt5BB8Y2-8gQUsmvFoyyxj-mObjx9hrYQRA9cgWu3ZHIMOuY621nV5C6mIIxtdP_xAsi4NG0drp1QDcbE1dRqw29OutHlm7EbRkcH020Qhxgwlr15YZLk2r9fBOQ-4dxk6mdq0N30LGEts2dzwjVTqifHvBUkoIe90N31bvFb7iTwg7VDDLD7ke1M3UKhLcNzC6pKNQLFEUq5t_9ojkhBxpASbeCYIzrBhA7u3dLNMo6q5gtF0ji7FSvMc1cjVOqM0OzC9c8dfz-nGbGlqZWvwqheSmBc1HiCnq5zM4RUJ29gwkILdc19dwGBUHyEQKf304V5FMtaPFN8VGWFPoSyXurqCvxwsiu4hkDr3XdPqT4TV5zFLNXnuvFxPDah-akiWZMsKVlzwE5c0A0tg2l3Z-qk59oQ5_0Gvkn773mVgw\"}",
    "ClusterId": "default",
    "GroupId": "group-12eyqbju",
    "Language": "zh-CN",
    "OperatorUin": "110000000617",
    "Region": "region-name",
    "RequestId": "572e55dd-ec61-e78c-1ead-46271433c6f0",
    "SubAccountUin": "110000000617",
    "Uin": "110000000617"
}

输出示例

{
    "Response": {
        "RequestId": "572e55dd-ec61-e78c-1ead-46271433c6f0",
        "Result": {
            "Clients": [
                {
                    "Addresses": [
                        "10.0.8.208:57108",
                        "10.0.8.208:57570"
                    ],
                    "Name": "fmt-inventory-yvonne",
                    "SdkVersion": "3.2-RELEASE"
                },
                {
                    "Addresses": [
                        "10.0.8.208:57142",
                        "10.0.8.208:60658"
                    ],
                    "Name": "fmt-payment-yvonne",
                    "SdkVersion": "3.2-RELEASE"
                },
                {
                    "Addresses": [
                        "10.0.8.208:57090",
                        "10.0.8.208:57566"
                    ],
                    "Name": "fmt-point-yvonne",
                    "SdkVersion": "3.2-RELEASE"
                },
                {
                    "Addresses": [
                        "10.0.8.208:32866",
                        "10.0.8.208:57110"
                    ],
                    "Name": "fmt-order-yvonne",
                    "SdkVersion": "3.2-RELEASE"
                }
            ],
            "CollectionTime": "2025-04-10 06:54:59 GMT"
        }
    }
}