GET白名单 · 查询列表/client/dynamics/account/allow/ip/list商户密钥 / 登录令牌
- 只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。
请求参数
| 参数 | 位置 / 类型 | 必填 | 说明 |
|---|---|---|---|
| id | query / Long | 否 / 依业务条件 | 记录 ID |
| accountId | query / Long | 否 / 依业务条件 | 动态账号 ID；从账号列表读取 |
| ipAddress | query / String | 否 / 依业务条件 | 允许访问的 IP 地址 |
| pageNum | query / Integer | 否 / 依业务条件 | 页码，从 1 开始 |
| pageSize | query / Integer | 否 / 依业务条件 | 每页条数 |
请求示例
curl -X GET "https://ly-proxy.com/api/proxy/client/dynamics/account/allow/ip/list?pageNum=1&pageSize=10" \
-H "x-merchant-code: YOUR_MERCHANT_CODE" \
-H "x-merchant-token: YOUR_MERCHANT_TOKEN"返回示例
以下是说明性示例。JSON 的 code 是业务状态，不等同于 HTTP 状态；msg、可选字段和具体数值以实际返回为准。
成功返回（示例）application/json
{
"code": 200,
"msg": "查询成功",
"total": 1,
"rows": [
{
"id": 1001,
"merchantId": 1000,
"accountId": 1001,
"ipAddress": "198.51.100.10"
}
]
}空列表application/json
{
"code": 200,
"msg": "查询成功",
"total": 0,
"rows": []
}鉴权失败（公共错误形状）application/json
{
"code": 401,
"msg": "认证失败，请重新登录或检查商户密钥"
}返回字段说明 · 8 项
| 字段路径 | 类型 | 说明 |
|---|---|---|
| code | number | 业务状态；200 成功，非 HTTP 状态码 |
| msg | string | 说明文字，随语言/业务场景变化 |
| total | number | 匹配记录总数 |
| rows | array | 分页记录数组 |
| rows[].id | number | 记录 ID |
| rows[].merchantId | number | 返回模型字段 |
| rows[].accountId | number | 动态账号 ID；从账号列表读取 |
| rows[].ipAddress | string | 允许访问的 IP 地址 |
对象为空时 data 可省略；实体元数据字段可能额外出现。不要依赖字段顺序或固定 msg 文案。
定义：ClientIpDynamicsAccountAllowIpController.java · list()