{
  "openapi": "3.0.3",
  "info": {
    "title": "Ly-Proxy 动态 / 静态代理 API",
    "version": "2026-10-16",
    "description": "所有示例均为说明性数据，不含生产客户账密；金额、库存、延迟和流量均非实时指标。"
  },
  "servers": [
    {
      "url": "https://ly-proxy.com/api/proxy"
    }
  ],
  "paths": {
    "/client/dynamics/account/allow/ip/list": {
      "get": {
        "operationId": "get-client-dynamics-account-allow-ip-list",
        "summary": "白名单 · 查询列表",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "accountId",
            "in": "query",
            "required": false,
            "description": "动态账号 ID；从账号列表读取",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "ipAddress",
            "in": "query",
            "required": false,
            "description": "允许访问的 IP 地址",
            "schema": {
              "type": "string"
            },
            "example": "198.51.100.10"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "accountId": {
                            "type": "number"
                          },
                          "ipAddress": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "accountId": 1001,
                          "ipAddress": "198.51.100.10"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/allow/ip/{id}": {
      "get": {
        "operationId": "get-client-dynamics-account-allow-ip-id",
        "summary": "白名单 · 查询详情",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "number"
                        },
                        "merchantId": {
                          "type": "number"
                        },
                        "accountId": {
                          "type": "number"
                        },
                        "ipAddress": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "id": 1001,
                        "merchantId": 1000,
                        "accountId": 1001,
                        "ipAddress": "198.51.100.10"
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/allow/ip": {
      "post": {
        "operationId": "post-client-dynamics-account-allow-ip",
        "summary": "白名单 · 创建记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "accountId": {
                    "type": "number"
                  },
                  "ipAddress": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "id": 1001,
                "accountId": 1001,
                "ipAddress": "198.51.100.10"
              }
            }
          }
        }
      },
      "put": {
        "operationId": "put-client-dynamics-account-allow-ip",
        "summary": "白名单 · 修改记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "accountId": {
                    "type": "number"
                  },
                  "ipAddress": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "id": 1001,
                "accountId": 1001,
                "ipAddress": "198.51.100.10"
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/allow/ip/{ids}": {
      "delete": {
        "operationId": "delete-client-dynamics-account-allow-ip-ids",
        "summary": "白名单 · 删除记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "ids",
            "in": "path",
            "required": true,
            "description": "返回模型字段",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "example": [
              1
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/balance/list": {
      "get": {
        "operationId": "get-client-dynamics-account-balance-list",
        "summary": "流量分配记录 · 查询列表",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "accountId",
            "in": "query",
            "required": false,
            "description": "动态账号 ID；从账号列表读取",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "accountId": {
                            "type": "number"
                          },
                          "balance": {
                            "type": "number"
                          },
                          "balanceFormat": {
                            "type": "string"
                          },
                          "balanceTotal": {
                            "type": "number"
                          },
                          "balanceTotalFormat": {
                            "type": "string"
                          },
                          "balanceUsed": {
                            "type": "number"
                          },
                          "balanceUsedFormat": {
                            "type": "string"
                          },
                          "threadsUsed": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "accountId": 1001,
                          "balance": 50,
                          "balanceFormat": "DEMO_VALUE",
                          "balanceTotal": 1.0,
                          "balanceTotalFormat": "DEMO_VALUE",
                          "balanceUsed": 1.0,
                          "balanceUsedFormat": "DEMO_VALUE",
                          "threadsUsed": "DEMO_VALUE"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/balance/{id}": {
      "get": {
        "operationId": "get-client-dynamics-account-balance-id",
        "summary": "流量分配记录 · 查询详情",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "number"
                        },
                        "merchantId": {
                          "type": "number"
                        },
                        "accountId": {
                          "type": "number"
                        },
                        "balance": {
                          "type": "number"
                        },
                        "balanceFormat": {
                          "type": "string"
                        },
                        "balanceTotal": {
                          "type": "number"
                        },
                        "balanceTotalFormat": {
                          "type": "string"
                        },
                        "balanceUsed": {
                          "type": "number"
                        },
                        "balanceUsedFormat": {
                          "type": "string"
                        },
                        "threadsUsed": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "id": 1001,
                        "merchantId": 1000,
                        "accountId": 1001,
                        "balance": 50,
                        "balanceFormat": "DEMO_VALUE",
                        "balanceTotal": 1.0,
                        "balanceTotalFormat": "DEMO_VALUE",
                        "balanceUsed": 1.0,
                        "balanceUsedFormat": "DEMO_VALUE",
                        "threadsUsed": "DEMO_VALUE"
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/balance/add": {
      "post": {
        "operationId": "post-client-dynamics-account-balance-add",
        "summary": "流量分配记录 · 创建记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。\n流量池 A 仅支持整数 GB；流量池余额不足时应停止分配，不要创建新订单补偿。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "流量池余额不足"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "accountId": {
                    "type": "number"
                  },
                  "trafficLimit": {
                    "type": "number"
                  }
                }
              },
              "example": {
                "accountId": 1001,
                "trafficLimit": 1
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/balance": {
      "put": {
        "operationId": "put-client-dynamics-account-balance",
        "summary": "流量分配记录 · 修改记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "accountId": {
                    "type": "number"
                  },
                  "balance": {
                    "type": "number"
                  },
                  "balanceFormat": {
                    "type": "string"
                  },
                  "balanceTotal": {
                    "type": "number"
                  },
                  "balanceTotalFormat": {
                    "type": "string"
                  },
                  "balanceUsed": {
                    "type": "number"
                  },
                  "balanceUsedFormat": {
                    "type": "string"
                  },
                  "threadsUsed": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "id": 1001,
                "accountId": 1001,
                "balance": 50,
                "balanceFormat": "DEMO_VALUE",
                "balanceTotal": 1.0,
                "balanceTotalFormat": "DEMO_VALUE",
                "balanceUsed": 1.0,
                "balanceUsedFormat": "DEMO_VALUE",
                "threadsUsed": "DEMO_VALUE"
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/balance/{ids}": {
      "delete": {
        "operationId": "delete-client-dynamics-account-balance-ids",
        "summary": "流量分配记录 · 删除记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "ids",
            "in": "path",
            "required": true,
            "description": "返回模型字段",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "example": [
              1
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "账号剩余流量不足"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/balance/recycle": {
      "post": {
        "operationId": "post-client-dynamics-account-balance-recycle",
        "summary": "回收流量",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。\naccountId 和 traffic 是 Query 参数，不是 JSON Body。回收数量不能超过账号可回收流量。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "accountId",
            "in": "query",
            "required": true,
            "description": "动态账号 ID；从账号列表读取",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "traffic",
            "in": "query",
            "required": true,
            "description": "回收流量，GB；流量池 A 按整数 GB",
            "schema": {
              "type": "number"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "账号剩余流量不足"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/list": {
      "get": {
        "operationId": "get-client-dynamics-account-list",
        "summary": "动态账号 · 查询列表",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "accountId",
            "in": "query",
            "required": false,
            "description": "动态账号 ID；从账号列表读取",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "label",
            "in": "query",
            "required": false,
            "description": "子账号显示名称",
            "schema": {
              "type": "string"
            },
            "example": "demo-team"
          },
          {
            "name": "channelLabel",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "poolType",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "email",
            "in": "query",
            "required": false,
            "description": "子账号邮箱/标识；按当前上游要求填写",
            "schema": {
              "type": "string"
            },
            "example": "demo-account@example.invalid"
          },
          {
            "name": "account",
            "in": "query",
            "required": false,
            "description": "代理认证账号",
            "schema": {
              "type": "string"
            },
            "example": "demo_account"
          },
          {
            "name": "password",
            "in": "query",
            "required": false,
            "description": "代理认证密码；示例值不是生产凭证",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_PASSWORD"
          },
          {
            "name": "threads",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "stickyRangeStart",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "stickyRangeEnd",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "blocked",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "blockedHosts",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "defaultPoolParametersCountries",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "defaultPoolParametersCities",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "defaultPoolParametersStates",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "defaultPoolParametersZipcodes",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "defaultPoolParametersAsns",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "defaultPoolParametersExcludeCountries",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "defaultPoolParametersExcludeAsn",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "defaultPoolParametersAnonymousFilter",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "defaultPoolParametersRotationInterval",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "trafficLimit",
            "in": "query",
            "required": false,
            "description": "分配或调整流量，GB；流量池 A 按整数 GB",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "defaultEndpointHost",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "dp1.ly-proxy.com"
          },
          {
            "name": "defaultEndpointPort",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "10000"
          },
          {
            "name": "remarks",
            "in": "query",
            "required": false,
            "description": "备注",
            "schema": {
              "type": "string"
            },
            "example": "示例备注"
          },
          {
            "name": "endpoint",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "dp1.ly-proxy.com:10000"
          },
          {
            "name": "protocolse",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "SOCKS5"
          },
          {
            "name": "capacity",
            "in": "query",
            "required": false,
            "description": "流量容量，GB",
            "schema": {
              "type": "number"
            },
            "example": 10
          },
          {
            "name": "totalTraffic",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 10
          },
          {
            "name": "usedTraffic",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 2
          },
          {
            "name": "remainingTraffic",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 8
          },
          {
            "name": "usageRate",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 20
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "accountId": {
                            "type": "number"
                          },
                          "sourceId": {
                            "type": "number"
                          },
                          "label": {
                            "type": "string"
                          },
                          "channelLabel": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "poolType": {
                            "type": "string"
                          },
                          "email": {
                            "type": "string"
                          },
                          "account": {
                            "type": "string"
                          },
                          "password": {
                            "type": "string"
                          },
                          "threads": {
                            "type": "number"
                          },
                          "stickyRangeStart": {
                            "type": "number"
                          },
                          "stickyRangeEnd": {
                            "type": "number"
                          },
                          "blocked": {
                            "type": "string"
                          },
                          "blockedHosts": {
                            "type": "string"
                          },
                          "defaultPoolParametersCountries": {
                            "type": "string"
                          },
                          "defaultPoolParametersCities": {
                            "type": "string"
                          },
                          "defaultPoolParametersStates": {
                            "type": "string"
                          },
                          "defaultPoolParametersZipcodes": {
                            "type": "string"
                          },
                          "defaultPoolParametersAsns": {
                            "type": "string"
                          },
                          "defaultPoolParametersExcludeCountries": {
                            "type": "string"
                          },
                          "defaultPoolParametersExcludeAsn": {
                            "type": "string"
                          },
                          "defaultPoolParametersAnonymousFilter": {
                            "type": "string"
                          },
                          "defaultPoolParametersRotationInterval": {
                            "type": "string"
                          },
                          "trafficLimit": {
                            "type": "number"
                          },
                          "defaultEndpointHost": {
                            "type": "string"
                          },
                          "defaultEndpointPort": {
                            "type": "string"
                          },
                          "remarks": {
                            "type": "string"
                          },
                          "endpoint": {
                            "type": "string"
                          },
                          "protocolse": {
                            "type": "string"
                          },
                          "capacity": {
                            "type": "number"
                          },
                          "totalTraffic": {
                            "type": "number"
                          },
                          "usedTraffic": {
                            "type": "number"
                          },
                          "remainingTraffic": {
                            "type": "number"
                          },
                          "usageRate": {
                            "type": "number"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "accountId": 1001,
                          "sourceId": 1,
                          "label": "demo-team",
                          "channelLabel": "DEMO_VALUE",
                          "status": "1",
                          "poolType": "DEMO_VALUE",
                          "email": "demo-account@example.invalid",
                          "account": "demo_account",
                          "password": "DEMO_PASSWORD",
                          "threads": 1,
                          "stickyRangeStart": 1,
                          "stickyRangeEnd": 1,
                          "blocked": "DEMO_VALUE",
                          "blockedHosts": "DEMO_VALUE",
                          "defaultPoolParametersCountries": "DEMO_VALUE",
                          "defaultPoolParametersCities": "DEMO_VALUE",
                          "defaultPoolParametersStates": "DEMO_VALUE",
                          "defaultPoolParametersZipcodes": "DEMO_VALUE",
                          "defaultPoolParametersAsns": "DEMO_VALUE",
                          "defaultPoolParametersExcludeCountries": "DEMO_VALUE",
                          "defaultPoolParametersExcludeAsn": "DEMO_VALUE",
                          "defaultPoolParametersAnonymousFilter": "DEMO_VALUE",
                          "defaultPoolParametersRotationInterval": "DEMO_VALUE",
                          "trafficLimit": 1,
                          "defaultEndpointHost": "dp1.ly-proxy.com",
                          "defaultEndpointPort": "10000",
                          "remarks": "示例备注",
                          "endpoint": "dp1.ly-proxy.com:10000",
                          "protocolse": "SOCKS5",
                          "capacity": 10,
                          "totalTraffic": 10,
                          "usedTraffic": 2,
                          "remainingTraffic": 8,
                          "usageRate": 20
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/trafficRecord": {
      "get": {
        "operationId": "get-client-dynamics-account-trafficRecord",
        "summary": "账号流量记录",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "startTime",
            "in": "query",
            "required": false,
            "description": "查询开始时间",
            "schema": {
              "type": "string"
            },
            "example": "2026-10-01"
          },
          {
            "name": "endTime",
            "in": "query",
            "required": false,
            "description": "查询结束时间",
            "schema": {
              "type": "string"
            },
            "example": "2026-10-15"
          },
          {
            "name": "accountId",
            "in": "query",
            "required": false,
            "description": "动态账号 ID；从账号列表读取",
            "schema": {
              "type": "number"
            },
            "example": 1001
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；无记录时（示例）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "requestsTotal": {
                            "type": "number"
                          },
                          "trafficTotal": {
                            "type": "number"
                          },
                          "dUsage": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": [
                        {
                          "requestsTotal": 100,
                          "trafficTotal": 0.25,
                          "dUsage": "2026-10-15"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "无记录时（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/{id}": {
      "get": {
        "operationId": "get-client-dynamics-account-id",
        "summary": "动态账号 · 查询详情",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "number"
                        },
                        "merchantId": {
                          "type": "number"
                        },
                        "accountId": {
                          "type": "number"
                        },
                        "sourceId": {
                          "type": "number"
                        },
                        "label": {
                          "type": "string"
                        },
                        "channelLabel": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string"
                        },
                        "poolType": {
                          "type": "string"
                        },
                        "email": {
                          "type": "string"
                        },
                        "account": {
                          "type": "string"
                        },
                        "password": {
                          "type": "string"
                        },
                        "threads": {
                          "type": "number"
                        },
                        "stickyRangeStart": {
                          "type": "number"
                        },
                        "stickyRangeEnd": {
                          "type": "number"
                        },
                        "blocked": {
                          "type": "string"
                        },
                        "blockedHosts": {
                          "type": "string"
                        },
                        "defaultPoolParametersCountries": {
                          "type": "string"
                        },
                        "defaultPoolParametersCities": {
                          "type": "string"
                        },
                        "defaultPoolParametersStates": {
                          "type": "string"
                        },
                        "defaultPoolParametersZipcodes": {
                          "type": "string"
                        },
                        "defaultPoolParametersAsns": {
                          "type": "string"
                        },
                        "defaultPoolParametersExcludeCountries": {
                          "type": "string"
                        },
                        "defaultPoolParametersExcludeAsn": {
                          "type": "string"
                        },
                        "defaultPoolParametersAnonymousFilter": {
                          "type": "string"
                        },
                        "defaultPoolParametersRotationInterval": {
                          "type": "string"
                        },
                        "trafficLimit": {
                          "type": "number"
                        },
                        "defaultEndpointHost": {
                          "type": "string"
                        },
                        "defaultEndpointPort": {
                          "type": "string"
                        },
                        "remarks": {
                          "type": "string"
                        },
                        "endpoint": {
                          "type": "string"
                        },
                        "protocolse": {
                          "type": "string"
                        },
                        "capacity": {
                          "type": "number"
                        },
                        "totalTraffic": {
                          "type": "number"
                        },
                        "usedTraffic": {
                          "type": "number"
                        },
                        "remainingTraffic": {
                          "type": "number"
                        },
                        "usageRate": {
                          "type": "number"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "id": 1001,
                        "merchantId": 1000,
                        "accountId": 1001,
                        "sourceId": 1,
                        "label": "demo-team",
                        "channelLabel": "DEMO_VALUE",
                        "status": "1",
                        "poolType": "DEMO_VALUE",
                        "email": "demo-account@example.invalid",
                        "account": "demo_account",
                        "password": "DEMO_PASSWORD",
                        "threads": 1,
                        "stickyRangeStart": 1,
                        "stickyRangeEnd": 1,
                        "blocked": "DEMO_VALUE",
                        "blockedHosts": "DEMO_VALUE",
                        "defaultPoolParametersCountries": "DEMO_VALUE",
                        "defaultPoolParametersCities": "DEMO_VALUE",
                        "defaultPoolParametersStates": "DEMO_VALUE",
                        "defaultPoolParametersZipcodes": "DEMO_VALUE",
                        "defaultPoolParametersAsns": "DEMO_VALUE",
                        "defaultPoolParametersExcludeCountries": "DEMO_VALUE",
                        "defaultPoolParametersExcludeAsn": "DEMO_VALUE",
                        "defaultPoolParametersAnonymousFilter": "DEMO_VALUE",
                        "defaultPoolParametersRotationInterval": "DEMO_VALUE",
                        "trafficLimit": 1,
                        "defaultEndpointHost": "dp1.ly-proxy.com",
                        "defaultEndpointPort": "10000",
                        "remarks": "示例备注",
                        "endpoint": "dp1.ly-proxy.com:10000",
                        "protocolse": "SOCKS5",
                        "capacity": 10,
                        "totalTraffic": 10,
                        "usedTraffic": 2,
                        "remainingTraffic": 8,
                        "usageRate": 20
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account": {
      "post": {
        "operationId": "post-client-dynamics-account",
        "summary": "动态账号 · 创建记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。\n允许先创建子账号再购买/分配流量；成功返回受影响行数状态，不直接返回新账号账密，请再查询账号列表。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string"
                  },
                  "email": {
                    "type": "string"
                  },
                  "trafficLimit": {
                    "type": "number"
                  }
                }
              },
              "example": {
                "label": "demo-team",
                "email": "demo-account@example.invalid",
                "trafficLimit": 0
              }
            }
          }
        }
      },
      "put": {
        "operationId": "put-client-dynamics-account",
        "summary": "动态账号 · 修改记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "trafficLimit": {
                    "type": "number"
                  },
                  "label": {
                    "type": "string"
                  },
                  "account": {
                    "type": "string"
                  },
                  "password": {
                    "type": "string"
                  },
                  "accountId": {
                    "type": "number"
                  },
                  "remarks": {
                    "type": "string"
                  },
                  "sourceCode": {
                    "type": "string"
                  },
                  "protocols": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              },
              "example": {
                "id": 1001,
                "trafficLimit": 1,
                "label": "demo-team",
                "account": "demo_account",
                "password": "DEMO_PASSWORD",
                "accountId": 1001,
                "remarks": "示例备注",
                "sourceCode": "DEMO_VALUE",
                "protocols": [
                  "socks5"
                ]
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/{ids}": {
      "delete": {
        "operationId": "delete-client-dynamics-account-ids",
        "summary": "动态账号 · 删除记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "ids",
            "in": "path",
            "required": true,
            "description": "返回模型字段",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "example": [
              1
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/generate-lines": {
      "post": {
        "operationId": "post-client-dynamics-account-generate-lines",
        "summary": "生成代理线路",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。\n流量池 A 使用 SOCKS5。249 个标准国家/地区代码不表示所有地区实时有库存。\n该控制器对 GET/POST 均返回 JSON 包装；data.text 是换行连接，data.lines 是数组；dataType 不把 HTTP 响应变成纯文本。\n只传国家时按国家定位；当前代码仅拼接城市，省/州字段不参与账号生成。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "lines": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "text": {
                          "type": "string"
                        },
                        "apiUrl": {
                          "type": "string"
                        },
                        "gateway": {
                          "type": "string"
                        },
                        "username": {
                          "type": "string"
                        },
                        "protocol": {
                          "type": "string"
                        },
                        "format": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "lines": [
                          "demo_account_c_US:DEMO_PASSWORD@dp1.ly-proxy.com:10000"
                        ],
                        "text": "demo_account_c_US:DEMO_PASSWORD@dp1.ly-proxy.com:10000",
                        "apiUrl": "/client/dynamics/account/generate-lines?accountId=1001&countryCode=US&protocol=SOCKS5&format=USER_PASS_AT_HOST_PORT&quantity=1",
                        "gateway": "dp1.ly-proxy.com:10000",
                        "username": "demo_account_c_US",
                        "protocol": "SOCKS5",
                        "format": "USER_PASS_AT_HOST_PORT"
                      }
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "accountId": {
                    "type": "number"
                  },
                  "countryCode": {
                    "type": "string"
                  },
                  "state": {
                    "type": "string"
                  },
                  "city": {
                    "type": "string"
                  },
                  "protocol": {
                    "type": "string"
                  },
                  "format": {
                    "type": "string"
                  },
                  "rotationMode": {
                    "type": "string"
                  },
                  "ttlMinutes": {
                    "type": "number"
                  },
                  "dataType": {
                    "type": "string"
                  },
                  "separator": {
                    "type": "string"
                  },
                  "gateway": {
                    "type": "string"
                  },
                  "quantity": {
                    "type": "number"
                  }
                }
              },
              "example": {
                "accountId": 1001,
                "countryCode": "US",
                "state": "",
                "city": "",
                "protocol": "SOCKS5",
                "format": "USER_PASS_AT_HOST_PORT",
                "rotationMode": "ROTATE",
                "ttlMinutes": 5,
                "dataType": "TEXT",
                "separator": "CRLF",
                "gateway": "dp1.ly-proxy.com:10000",
                "quantity": 1
              }
            }
          }
        }
      },
      "get": {
        "operationId": "get-client-dynamics-account-generate-lines",
        "summary": "生成代理线路（查询参数）",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。\n流量池 A 使用 SOCKS5。249 个标准国家/地区代码不表示所有地区实时有库存。\n该控制器对 GET/POST 均返回 JSON 包装；data.text 是换行连接，data.lines 是数组；dataType 不把 HTTP 响应变成纯文本。\n只传国家时按国家定位；当前代码仅拼接城市，省/州字段不参与账号生成。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "accountId",
            "in": "query",
            "required": true,
            "description": "动态账号 ID；从账号列表读取",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "countryCode",
            "in": "query",
            "required": true,
            "description": "两位国家/地区代码，例如 US、TH、GB",
            "schema": {
              "type": "string"
            },
            "example": "US"
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "description": "可选；当前生成器不将省/州拼入账号",
            "schema": {
              "type": "string"
            },
            "example": ""
          },
          {
            "name": "city",
            "in": "query",
            "required": false,
            "description": "可选城市定位值，使用上游支持的名称",
            "schema": {
              "type": "string"
            },
            "example": ""
          },
          {
            "name": "protocol",
            "in": "query",
            "required": false,
            "description": "SOCKS5 / HTTP；流量池 A 使用 SOCKS5",
            "schema": {
              "type": "string"
            },
            "example": "SOCKS5"
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "USER_PASS_AT_HOST_PORT / HOST_PORT_USER_PASS / PROTOCOL_URL",
            "schema": {
              "type": "string"
            },
            "example": "USER_PASS_AT_HOST_PORT"
          },
          {
            "name": "rotationMode",
            "in": "query",
            "required": false,
            "description": "ROTATE 或 STICKY",
            "schema": {
              "type": "string"
            },
            "example": "ROTATE"
          },
          {
            "name": "ttlMinutes",
            "in": "query",
            "required": false,
            "description": "粘性会话分钟数，服务端限制 1–120",
            "schema": {
              "type": "number"
            },
            "example": 5
          },
          {
            "name": "dataType",
            "in": "query",
            "required": false,
            "description": "JSON / TEXT 标识；该控制器仍返回 JSON，连接文本在 data.text",
            "schema": {
              "type": "string"
            },
            "example": "TEXT"
          },
          {
            "name": "separator",
            "in": "query",
            "required": false,
            "description": "CRLF（默认）/ LF / COMMA",
            "schema": {
              "type": "string"
            },
            "example": "CRLF"
          },
          {
            "name": "gateway",
            "in": "query",
            "required": false,
            "description": "使用账号返回的网关，SOCKS5 示例为 dp1.ly-proxy.com:10000",
            "schema": {
              "type": "string"
            },
            "example": "dp1.ly-proxy.com:10000"
          },
          {
            "name": "quantity",
            "in": "query",
            "required": false,
            "description": "生成数量，1–1000",
            "schema": {
              "type": "number"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "lines": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "text": {
                          "type": "string"
                        },
                        "apiUrl": {
                          "type": "string"
                        },
                        "gateway": {
                          "type": "string"
                        },
                        "username": {
                          "type": "string"
                        },
                        "protocol": {
                          "type": "string"
                        },
                        "format": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "lines": [
                          "demo_account_c_US:DEMO_PASSWORD@dp1.ly-proxy.com:10000"
                        ],
                        "text": "demo_account_c_US:DEMO_PASSWORD@dp1.ly-proxy.com:10000",
                        "apiUrl": "/client/dynamics/account/generate-lines?accountId=1001&countryCode=US&protocol=SOCKS5&format=USER_PASS_AT_HOST_PORT&quantity=1",
                        "gateway": "dp1.ly-proxy.com:10000",
                        "username": "demo_account_c_US",
                        "protocol": "SOCKS5",
                        "format": "USER_PASS_AT_HOST_PORT"
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/endpoint/list": {
      "get": {
        "operationId": "get-client-dynamics-account-endpoint-list",
        "summary": "网关接入点 · 查询列表",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "accountId",
            "in": "query",
            "required": false,
            "description": "动态账号 ID；从账号列表读取",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "endpointHost",
            "in": "query",
            "required": false,
            "description": "账号网关主机",
            "schema": {
              "type": "string"
            },
            "example": "dp1.ly-proxy.com"
          },
          {
            "name": "endpointPort",
            "in": "query",
            "required": false,
            "description": "账号网关端口",
            "schema": {
              "type": "number"
            },
            "example": 10000
          },
          {
            "name": "endpointStatus",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "expireTime",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-14 12:00:00"
          },
          {
            "name": "useTrafficGb",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 2
          },
          {
            "name": "limitTrafficGb",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 10
          },
          {
            "name": "supportedProtocol",
            "in": "query",
            "required": false,
            "description": "协议，SOCKS5 或 HTTP",
            "schema": {
              "type": "string"
            },
            "example": "SOCKS5"
          },
          {
            "name": "remarks",
            "in": "query",
            "required": false,
            "description": "备注",
            "schema": {
              "type": "string"
            },
            "example": "示例备注"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "accountId": {
                            "type": "number"
                          },
                          "endpointHost": {
                            "type": "string"
                          },
                          "endpointPort": {
                            "type": "number"
                          },
                          "endpointStatus": {
                            "type": "number"
                          },
                          "expireTime": {
                            "type": "string"
                          },
                          "useTrafficGb": {
                            "type": "number"
                          },
                          "limitTrafficGb": {
                            "type": "number"
                          },
                          "supportedProtocol": {
                            "type": "string"
                          },
                          "remarks": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "accountId": 1001,
                          "endpointHost": "dp1.ly-proxy.com",
                          "endpointPort": 10000,
                          "endpointStatus": 1,
                          "expireTime": "2026-11-14 12:00:00",
                          "useTrafficGb": 2,
                          "limitTrafficGb": 10,
                          "supportedProtocol": "SOCKS5",
                          "remarks": "示例备注"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/endpoint/export": {
      "post": {
        "operationId": "post-client-dynamics-account-endpoint-export",
        "summary": "网关接入点 · 导出 Excel",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "accountId",
            "in": "query",
            "required": false,
            "description": "动态账号 ID；从账号列表读取",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "endpointHost",
            "in": "query",
            "required": false,
            "description": "账号网关主机",
            "schema": {
              "type": "string"
            },
            "example": "dp1.ly-proxy.com"
          },
          {
            "name": "endpointPort",
            "in": "query",
            "required": false,
            "description": "账号网关端口",
            "schema": {
              "type": "number"
            },
            "example": 10000
          },
          {
            "name": "endpointStatus",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "expireTime",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-14 12:00:00"
          },
          {
            "name": "useTrafficGb",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 2
          },
          {
            "name": "limitTrafficGb",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 10
          },
          {
            "name": "supportedProtocol",
            "in": "query",
            "required": false,
            "description": "协议，SOCKS5 或 HTTP",
            "schema": {
              "type": "string"
            },
            "example": "SOCKS5"
          },
          {
            "name": "remarks",
            "in": "query",
            "required": false,
            "description": "备注",
            "schema": {
              "type": "string"
            },
            "example": "示例备注"
          }
        ],
        "responses": {
          "200": {
            "description": "Excel 下载成功；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                },
                "examples": {
                  "example_1": {
                    "summary": "Excel 下载成功",
                    "value": "HTTP/1.1 200 OK\nContent-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\nContent-Disposition: attachment; filename=\"example.xlsx\"\n\n<binary XLSX bytes>"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/endpoint/{id}": {
      "get": {
        "operationId": "get-client-dynamics-account-endpoint-id",
        "summary": "网关接入点 · 查询详情",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "number"
                        },
                        "merchantId": {
                          "type": "number"
                        },
                        "accountId": {
                          "type": "number"
                        },
                        "endpointHost": {
                          "type": "string"
                        },
                        "endpointPort": {
                          "type": "number"
                        },
                        "endpointStatus": {
                          "type": "number"
                        },
                        "expireTime": {
                          "type": "string"
                        },
                        "useTrafficGb": {
                          "type": "number"
                        },
                        "limitTrafficGb": {
                          "type": "number"
                        },
                        "supportedProtocol": {
                          "type": "string"
                        },
                        "remarks": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "id": 1001,
                        "merchantId": 1000,
                        "accountId": 1001,
                        "endpointHost": "dp1.ly-proxy.com",
                        "endpointPort": 10000,
                        "endpointStatus": 1,
                        "expireTime": "2026-11-14 12:00:00",
                        "useTrafficGb": 2,
                        "limitTrafficGb": 10,
                        "supportedProtocol": "SOCKS5",
                        "remarks": "示例备注"
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/endpoint": {
      "post": {
        "operationId": "post-client-dynamics-account-endpoint",
        "summary": "网关接入点 · 创建记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n高级维护接口。网关、协议和统计记录通常由系统/上游同步；写入记录不代表上游能力已开通。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "accountId": {
                    "type": "number"
                  },
                  "endpointHost": {
                    "type": "string"
                  },
                  "endpointPort": {
                    "type": "number"
                  },
                  "endpointStatus": {
                    "type": "number"
                  },
                  "expireTime": {
                    "type": "string"
                  },
                  "useTrafficGb": {
                    "type": "number"
                  },
                  "limitTrafficGb": {
                    "type": "number"
                  },
                  "supportedProtocol": {
                    "type": "string"
                  },
                  "remarks": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "id": 1001,
                "accountId": 1001,
                "endpointHost": "dp1.ly-proxy.com",
                "endpointPort": 10000,
                "endpointStatus": 1,
                "expireTime": "2026-11-14 12:00:00",
                "useTrafficGb": 2,
                "limitTrafficGb": 10,
                "supportedProtocol": "SOCKS5",
                "remarks": "示例备注"
              }
            }
          }
        }
      },
      "put": {
        "operationId": "put-client-dynamics-account-endpoint",
        "summary": "网关接入点 · 修改记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n高级维护接口。网关、协议和统计记录通常由系统/上游同步；写入记录不代表上游能力已开通。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "accountId": {
                    "type": "number"
                  },
                  "endpointHost": {
                    "type": "string"
                  },
                  "endpointPort": {
                    "type": "number"
                  },
                  "endpointStatus": {
                    "type": "number"
                  },
                  "expireTime": {
                    "type": "string"
                  },
                  "useTrafficGb": {
                    "type": "number"
                  },
                  "limitTrafficGb": {
                    "type": "number"
                  },
                  "supportedProtocol": {
                    "type": "string"
                  },
                  "remarks": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "id": 1001,
                "accountId": 1001,
                "endpointHost": "dp1.ly-proxy.com",
                "endpointPort": 10000,
                "endpointStatus": 1,
                "expireTime": "2026-11-14 12:00:00",
                "useTrafficGb": 2,
                "limitTrafficGb": 10,
                "supportedProtocol": "SOCKS5",
                "remarks": "示例备注"
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/endpoint/{ids}": {
      "delete": {
        "operationId": "delete-client-dynamics-account-endpoint-ids",
        "summary": "网关接入点 · 删除记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n高级维护接口。网关、协议和统计记录通常由系统/上游同步；写入记录不代表上游能力已开通。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "ids",
            "in": "path",
            "required": true,
            "description": "返回模型字段",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "example": [
              1
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/protocol/list": {
      "get": {
        "operationId": "get-client-dynamics-account-protocol-list",
        "summary": "支持协议 · 查询列表",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "accountId",
            "in": "query",
            "required": false,
            "description": "动态账号 ID；从账号列表读取",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "supportedProtocol",
            "in": "query",
            "required": false,
            "description": "协议，SOCKS5 或 HTTP",
            "schema": {
              "type": "string"
            },
            "example": "SOCKS5"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "accountId": {
                            "type": "number"
                          },
                          "supportedProtocol": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "accountId": 1001,
                          "supportedProtocol": "SOCKS5"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/protocol/{id}": {
      "get": {
        "operationId": "get-client-dynamics-account-protocol-id",
        "summary": "支持协议 · 查询详情",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "number"
                        },
                        "merchantId": {
                          "type": "number"
                        },
                        "accountId": {
                          "type": "number"
                        },
                        "supportedProtocol": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "id": 1001,
                        "merchantId": 1000,
                        "accountId": 1001,
                        "supportedProtocol": "SOCKS5"
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/protocol": {
      "post": {
        "operationId": "post-client-dynamics-account-protocol",
        "summary": "支持协议 · 创建记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n高级维护接口。网关、协议和统计记录通常由系统/上游同步；写入记录不代表上游能力已开通。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "accountId": {
                    "type": "number"
                  },
                  "supportedProtocol": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "id": 1001,
                "accountId": 1001,
                "supportedProtocol": "SOCKS5"
              }
            }
          }
        }
      },
      "put": {
        "operationId": "put-client-dynamics-account-protocol",
        "summary": "支持协议 · 修改记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n高级维护接口。网关、协议和统计记录通常由系统/上游同步；写入记录不代表上游能力已开通。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "accountId": {
                    "type": "number"
                  },
                  "supportedProtocol": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "id": 1001,
                "accountId": 1001,
                "supportedProtocol": "SOCKS5"
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/protocol/{ids}": {
      "delete": {
        "operationId": "delete-client-dynamics-account-protocol-ids",
        "summary": "支持协议 · 删除记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n高级维护接口。网关、协议和统计记录通常由系统/上游同步；写入记录不代表上游能力已开通。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "ids",
            "in": "path",
            "required": true,
            "description": "返回模型字段",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "example": [
              1
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/details/list": {
      "get": {
        "operationId": "get-client-dynamics-account-details-list",
        "summary": "用量明细 · 查询列表",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "accountId",
            "in": "query",
            "required": true,
            "description": "动态账号 ID；从账号列表读取",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "host",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "accountId": {
                            "type": "number"
                          },
                          "host": {
                            "type": "string"
                          },
                          "port": {
                            "type": "string"
                          },
                          "dataDatetime": {
                            "type": "string"
                          },
                          "requests": {
                            "type": "number"
                          },
                          "traffic": {
                            "type": "number"
                          },
                          "extraTraffic": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "accountId": 1001,
                          "host": "DEMO_VALUE",
                          "port": "62000",
                          "dataDatetime": "2026-10-15 12:00:00",
                          "requests": 1,
                          "traffic": 1,
                          "extraTraffic": "DEMO_VALUE",
                          "status": "1",
                          "message": "DEMO_VALUE"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/details/export": {
      "post": {
        "operationId": "post-client-dynamics-account-details-export",
        "summary": "用量明细 · 导出 Excel",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "accountId",
            "in": "query",
            "required": false,
            "description": "动态账号 ID；从账号列表读取",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "host",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "port",
            "in": "query",
            "required": false,
            "description": "代理端口，读取资源返回值，不固定写死",
            "schema": {
              "type": "string"
            },
            "example": "62000"
          },
          {
            "name": "dataDatetime",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "2026-10-15 12:00:00"
          },
          {
            "name": "requests",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "traffic",
            "in": "query",
            "required": false,
            "description": "回收流量，GB；流量池 A 按整数 GB",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "extraTraffic",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "message",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          }
        ],
        "responses": {
          "200": {
            "description": "Excel 下载成功；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                },
                "examples": {
                  "example_1": {
                    "summary": "Excel 下载成功",
                    "value": "HTTP/1.1 200 OK\nContent-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\nContent-Disposition: attachment; filename=\"example.xlsx\"\n\n<binary XLSX bytes>"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/details/{id}": {
      "get": {
        "operationId": "get-client-dynamics-account-details-id",
        "summary": "用量明细 · 查询详情",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "number"
                        },
                        "merchantId": {
                          "type": "number"
                        },
                        "accountId": {
                          "type": "number"
                        },
                        "host": {
                          "type": "string"
                        },
                        "port": {
                          "type": "string"
                        },
                        "dataDatetime": {
                          "type": "string"
                        },
                        "requests": {
                          "type": "number"
                        },
                        "traffic": {
                          "type": "number"
                        },
                        "extraTraffic": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "id": 1001,
                        "merchantId": 1000,
                        "accountId": 1001,
                        "host": "DEMO_VALUE",
                        "port": "62000",
                        "dataDatetime": "2026-10-15 12:00:00",
                        "requests": 1,
                        "traffic": 1,
                        "extraTraffic": "DEMO_VALUE",
                        "status": "1",
                        "message": "DEMO_VALUE"
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/details": {
      "post": {
        "operationId": "post-client-dynamics-account-details",
        "summary": "用量明细 · 创建记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n高级维护接口。网关、协议和统计记录通常由系统/上游同步；写入记录不代表上游能力已开通。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "accountId": {
                    "type": "number"
                  },
                  "host": {
                    "type": "string"
                  },
                  "port": {
                    "type": "string"
                  },
                  "dataDatetime": {
                    "type": "string"
                  },
                  "requests": {
                    "type": "number"
                  },
                  "traffic": {
                    "type": "number"
                  },
                  "extraTraffic": {
                    "type": "string"
                  },
                  "status": {
                    "type": "number"
                  },
                  "message": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "id": 1001,
                "accountId": 1001,
                "host": "DEMO_VALUE",
                "port": "62000",
                "dataDatetime": "2026-10-15 12:00:00",
                "requests": 1,
                "traffic": 1,
                "extraTraffic": "DEMO_VALUE",
                "status": 1,
                "message": "DEMO_VALUE"
              }
            }
          }
        }
      },
      "put": {
        "operationId": "put-client-dynamics-account-details",
        "summary": "用量明细 · 修改记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n高级维护接口。网关、协议和统计记录通常由系统/上游同步；写入记录不代表上游能力已开通。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "accountId": {
                    "type": "number"
                  },
                  "host": {
                    "type": "string"
                  },
                  "port": {
                    "type": "string"
                  },
                  "dataDatetime": {
                    "type": "string"
                  },
                  "requests": {
                    "type": "number"
                  },
                  "traffic": {
                    "type": "number"
                  },
                  "extraTraffic": {
                    "type": "string"
                  },
                  "status": {
                    "type": "number"
                  },
                  "message": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "id": 1001,
                "accountId": 1001,
                "host": "DEMO_VALUE",
                "port": "62000",
                "dataDatetime": "2026-10-15 12:00:00",
                "requests": 1,
                "traffic": 1,
                "extraTraffic": "DEMO_VALUE",
                "status": 1,
                "message": "DEMO_VALUE"
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/details/{ids}": {
      "delete": {
        "operationId": "delete-client-dynamics-account-details-ids",
        "summary": "用量明细 · 删除记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n高级维护接口。网关、协议和统计记录通常由系统/上游同步；写入记录不代表上游能力已开通。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ids",
            "in": "path",
            "required": true,
            "description": "返回模型字段",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "example": [
              1
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/stat/list": {
      "get": {
        "operationId": "get-client-dynamics-account-stat-list",
        "summary": "用量统计 · 查询列表",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "startTime",
            "in": "query",
            "required": false,
            "description": "查询开始时间",
            "schema": {
              "type": "string"
            },
            "example": "2026-10-01"
          },
          {
            "name": "endTime",
            "in": "query",
            "required": false,
            "description": "查询结束时间",
            "schema": {
              "type": "string"
            },
            "example": "2026-10-15"
          },
          {
            "name": "accountId",
            "in": "query",
            "required": false,
            "description": "动态账号 ID；从账号列表读取",
            "schema": {
              "type": "number"
            },
            "example": 1001
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；无记录时（示例）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "requestsTotal": {
                            "type": "number"
                          },
                          "trafficTotal": {
                            "type": "number"
                          },
                          "dUsage": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": [
                        {
                          "requestsTotal": 100,
                          "trafficTotal": 0.25,
                          "dUsage": "2026-10-15"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "无记录时（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/stat/{id}": {
      "get": {
        "operationId": "get-client-dynamics-account-stat-id",
        "summary": "用量统计 · 查询详情",
        "tags": [
          "dynamic"
        ],
        "description": "只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "number"
                        },
                        "merchantId": {
                          "type": "number"
                        },
                        "accountId": {
                          "type": "number"
                        },
                        "dUsage": {
                          "type": "string"
                        },
                        "requests": {
                          "type": "number"
                        },
                        "traffic": {
                          "type": "number"
                        },
                        "extraTraffic": {
                          "type": "number"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "id": 1001,
                        "merchantId": 1000,
                        "accountId": 1001,
                        "dUsage": "2026-10-15",
                        "requests": 1,
                        "traffic": 1,
                        "extraTraffic": 1.0
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/stat": {
      "post": {
        "operationId": "post-client-dynamics-account-stat",
        "summary": "用量统计 · 创建记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "accountId": {
                    "type": "number"
                  },
                  "dUsage": {
                    "type": "string"
                  },
                  "requests": {
                    "type": "number"
                  },
                  "traffic": {
                    "type": "number"
                  },
                  "extraTraffic": {
                    "type": "number"
                  }
                }
              },
              "example": {
                "id": 1001,
                "accountId": 1001,
                "dUsage": "2026-10-15",
                "requests": 1,
                "traffic": 1,
                "extraTraffic": 1.0
              }
            }
          }
        }
      },
      "put": {
        "operationId": "put-client-dynamics-account-stat",
        "summary": "用量统计 · 修改记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "accountId": {
                    "type": "number"
                  },
                  "dUsage": {
                    "type": "string"
                  },
                  "requests": {
                    "type": "number"
                  },
                  "traffic": {
                    "type": "number"
                  },
                  "extraTraffic": {
                    "type": "number"
                  }
                }
              },
              "example": {
                "id": 1001,
                "accountId": 1001,
                "dUsage": "2026-10-15",
                "requests": 1,
                "traffic": 1,
                "extraTraffic": 1.0
              }
            }
          }
        }
      }
    },
    "/client/dynamics/account/stat/{ids}": {
      "delete": {
        "operationId": "delete-client-dynamics-account-stat-ids",
        "summary": "用量统计 · 删除记录",
        "tags": [
          "dynamic"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n高级维护接口。网关、协议和统计记录通常由系统/上游同步；写入记录不代表上游能力已开通。\n只能操作当前鉴权身份所属资源；上游配额、协议和可用地区以账号实际返回为准。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ids",
            "in": "path",
            "required": true,
            "description": "返回模型字段",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "example": [
              1
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/plan/list": {
      "get": {
        "operationId": "get-client-plan-list",
        "summary": "动态套餐 · 查询列表",
        "tags": [
          "dynamic"
        ],
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "planTrafficGb",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 10
          },
          {
            "name": "expirationDate",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-14 12:00:00"
          },
          {
            "name": "expired",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "planResidueTrafficGb",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 8
          },
          {
            "name": "currentPlanItemId",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "planTrafficGb": {
                            "type": "number"
                          },
                          "expirationDate": {
                            "type": "string"
                          },
                          "expired": {
                            "type": "number"
                          },
                          "planResidueTrafficGb": {
                            "type": "number"
                          },
                          "currentPlanItemId": {
                            "type": "number"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "planTrafficGb": 10,
                          "expirationDate": "2026-11-14 12:00:00",
                          "expired": 1,
                          "planResidueTrafficGb": 8,
                          "currentPlanItemId": 1
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/plan/detail": {
      "get": {
        "operationId": "get-client-plan-detail",
        "summary": "查询流量池详情",
        "tags": [
          "dynamic"
        ],
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "number"
                        },
                        "merchantId": {
                          "type": "number"
                        },
                        "planTrafficGb": {
                          "type": "number"
                        },
                        "expirationDate": {
                          "type": "string"
                        },
                        "expired": {
                          "type": "number"
                        },
                        "planResidueTrafficGb": {
                          "type": "number"
                        },
                        "currentPlanItemId": {
                          "type": "number"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "id": 1001,
                        "merchantId": 1000,
                        "planTrafficGb": 10,
                        "expirationDate": "2026-11-14 12:00:00",
                        "expired": 1,
                        "planResidueTrafficGb": 8,
                        "currentPlanItemId": 1
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/plan/queryMainBalance": {
      "get": {
        "operationId": "get-client-plan-queryMainBalance",
        "summary": "刷新主流量池余额",
        "tags": [
          "dynamic"
        ],
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/plan/order/list": {
      "get": {
        "operationId": "get-client-plan-order-list",
        "summary": "动态套餐 · 查询列表",
        "tags": [
          "shared"
        ],
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          },
          {
            "name": "planName",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "planTrafficGb",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 10
          },
          {
            "name": "expirationDate",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-14 12:00:00"
          },
          {
            "name": "expired",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "price",
            "in": "query",
            "required": false,
            "description": "服务端实时价格，示例数值不构成报价",
            "schema": {
              "type": "number"
            },
            "example": 5
          },
          {
            "name": "pricePerGb",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1.0
          },
          {
            "name": "planTypeId",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "planResidueTrafficGb",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 8
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "planName": {
                            "type": "string"
                          },
                          "planTrafficGb": {
                            "type": "number"
                          },
                          "expirationDate": {
                            "type": "string"
                          },
                          "expired": {
                            "type": "number"
                          },
                          "price": {
                            "type": "number"
                          },
                          "pricePerGb": {
                            "type": "number"
                          },
                          "planTypeId": {
                            "type": "number"
                          },
                          "planResidueTrafficGb": {
                            "type": "number"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "planName": "DEMO_VALUE",
                          "planTrafficGb": 10,
                          "expirationDate": "2026-11-14 12:00:00",
                          "expired": 1,
                          "price": 5,
                          "pricePerGb": 1.0,
                          "planTypeId": 1,
                          "planResidueTrafficGb": 8
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/plan/order/{id}": {
      "get": {
        "operationId": "get-client-plan-order-id",
        "summary": "动态套餐 · 查询详情",
        "tags": [
          "shared"
        ],
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "记录 ID",
            "schema": {
              "type": "number"
            },
            "example": 1001
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "number"
                        },
                        "merchantId": {
                          "type": "number"
                        },
                        "planName": {
                          "type": "string"
                        },
                        "planTrafficGb": {
                          "type": "number"
                        },
                        "expirationDate": {
                          "type": "string"
                        },
                        "expired": {
                          "type": "number"
                        },
                        "price": {
                          "type": "number"
                        },
                        "pricePerGb": {
                          "type": "number"
                        },
                        "planTypeId": {
                          "type": "number"
                        },
                        "planResidueTrafficGb": {
                          "type": "number"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "id": 1001,
                        "merchantId": 1000,
                        "planName": "DEMO_VALUE",
                        "planTrafficGb": 10,
                        "expirationDate": "2026-11-14 12:00:00",
                        "expired": 1,
                        "price": 5,
                        "pricePerGb": 1.0,
                        "planTypeId": 1,
                        "planResidueTrafficGb": 8
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/dynamics/planConfig": {
      "get": {
        "operationId": "get-client-ip-dynamics-planConfig",
        "summary": "价格计划配置",
        "tags": [
          "dynamic"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "capacity",
            "in": "query",
            "required": false,
            "description": "流量容量，GB",
            "schema": {
              "type": "number"
            },
            "example": 10
          },
          {
            "name": "title",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "示例套餐"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "title": {
                            "type": "string"
                          },
                          "capacity": {
                            "type": "number"
                          },
                          "price": {
                            "type": "number"
                          },
                          "discount": {
                            "type": "number"
                          },
                          "status": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "title": "示例套餐",
                          "capacity": 10,
                          "price": 5,
                          "discount": 1,
                          "status": "Y"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/dynamics/list": {
      "get": {
        "operationId": "get-client-ip-dynamics-list",
        "summary": "动态IP列表",
        "tags": [
          "dynamic"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "capacity",
            "in": "query",
            "required": false,
            "description": "流量容量，GB",
            "schema": {
              "type": "number"
            },
            "example": 10
          },
          {
            "name": "title",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "示例套餐"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "title": {
                            "type": "string"
                          },
                          "capacity": {
                            "type": "number"
                          },
                          "price": {
                            "type": "number"
                          },
                          "discount": {
                            "type": "number"
                          },
                          "status": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "title": "示例套餐",
                          "capacity": 10,
                          "price": 5,
                          "discount": 1,
                          "status": "Y"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/dynamics/dayConfig": {
      "get": {
        "operationId": "get-client-ip-dynamics-dayConfig",
        "summary": "天数配置",
        "tags": [
          "dynamic"
        ],
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "有效天数",
            "schema": {
              "type": "number"
            },
            "example": 30
          },
          {
            "name": "discount",
            "in": "query",
            "required": false,
            "description": "折扣配置",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "price": {
                            "type": "number"
                          },
                          "currency": {
                            "type": "string"
                          },
                          "days": {
                            "type": "number"
                          },
                          "dayDiscount": {
                            "type": "number"
                          },
                          "status": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "price": 5,
                          "currency": "USD",
                          "days": 30,
                          "dayDiscount": 1,
                          "status": "Y"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/dynamics/planConfigWithOutAuth": {
      "get": {
        "operationId": "get-client-ip-dynamics-planConfigWithOutAuth",
        "summary": "价格计划配置(免鉴权)",
        "tags": [
          "dynamic"
        ],
        "description": "",
        "security": [],
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "capacity",
            "in": "query",
            "required": false,
            "description": "流量容量，GB",
            "schema": {
              "type": "number"
            },
            "example": 10
          },
          {
            "name": "title",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "示例套餐"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "title": {
                            "type": "string"
                          },
                          "capacity": {
                            "type": "number"
                          },
                          "price": {
                            "type": "number"
                          },
                          "discount": {
                            "type": "number"
                          },
                          "status": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "title": "示例套餐",
                          "capacity": 10,
                          "price": 5,
                          "discount": 1,
                          "status": "Y"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/dynamics/dayConfigWithOutAuth": {
      "get": {
        "operationId": "get-client-ip-dynamics-dayConfigWithOutAuth",
        "summary": "天数配置(免鉴权)",
        "tags": [
          "dynamic"
        ],
        "description": "",
        "security": [],
        "parameters": [
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "有效天数",
            "schema": {
              "type": "number"
            },
            "example": 30
          },
          {
            "name": "discount",
            "in": "query",
            "required": false,
            "description": "折扣配置",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "price": {
                            "type": "number"
                          },
                          "currency": {
                            "type": "string"
                          },
                          "days": {
                            "type": "number"
                          },
                          "dayDiscount": {
                            "type": "number"
                          },
                          "status": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "price": 5,
                          "currency": "USD",
                          "days": 30,
                          "dayDiscount": 1,
                          "status": "Y"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/static/confDaysList": {
      "get": {
        "operationId": "get-client-ip-static-confDaysList",
        "summary": "静态Ip天数折扣配置",
        "tags": [
          "static"
        ],
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ipType",
            "in": "query",
            "required": true,
            "description": "静态 IP 类型，0 普通/广播，1 原生",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "有效天数",
            "schema": {
              "type": "number"
            },
            "example": 30
          },
          {
            "name": "discount",
            "in": "query",
            "required": false,
            "description": "折扣配置",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "ipType": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "days": {
                            "type": "number"
                          },
                          "discount": {
                            "type": "number"
                          },
                          "status": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "ipType": 1,
                          "merchantId": 1000,
                          "days": 30,
                          "discount": 1,
                          "status": "Y"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/static/confNumList": {
      "get": {
        "operationId": "get-client-ip-static-confNumList",
        "summary": "静态Ip数量等级折扣配置",
        "tags": [
          "static"
        ],
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ipType",
            "in": "query",
            "required": true,
            "description": "静态 IP 类型，0 普通/广播，1 原生",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "totalIps",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "price",
            "in": "query",
            "required": false,
            "description": "服务端实时价格，示例数值不构成报价",
            "schema": {
              "type": "number"
            },
            "example": 5
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "countryCode",
            "in": "query",
            "required": false,
            "description": "两位国家/地区代码，例如 US、TH、GB",
            "schema": {
              "type": "string"
            },
            "example": "US"
          },
          {
            "name": "isExclusive",
            "in": "query",
            "required": false,
            "description": "资源类型标识，依实际购买配置使用",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "ipType": {
                            "type": "number"
                          },
                          "totalIps": {
                            "type": "number"
                          },
                          "price": {
                            "type": "number"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "isExclusive": {
                            "type": "number"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "ipType": 1,
                          "totalIps": 1,
                          "price": 5,
                          "countryCode": "US",
                          "status": "Y",
                          "merchantId": 1000,
                          "isExclusive": 1
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/static/confDaysListWithOutAuth": {
      "get": {
        "operationId": "get-client-ip-static-confDaysListWithOutAuth",
        "summary": "静态Ip天数折扣配置(免鉴权)",
        "tags": [
          "static"
        ],
        "description": "",
        "security": [],
        "parameters": [
          {
            "name": "ipType",
            "in": "query",
            "required": true,
            "description": "静态 IP 类型，0 普通/广播，1 原生",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "有效天数",
            "schema": {
              "type": "number"
            },
            "example": 30
          },
          {
            "name": "discount",
            "in": "query",
            "required": false,
            "description": "折扣配置",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "ipType": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "days": {
                            "type": "number"
                          },
                          "discount": {
                            "type": "number"
                          },
                          "status": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "ipType": 1,
                          "merchantId": 1000,
                          "days": 30,
                          "discount": 1,
                          "status": "Y"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/static/confNumListWithOutAuth": {
      "get": {
        "operationId": "get-client-ip-static-confNumListWithOutAuth",
        "summary": "静态Ip数量等级折扣配置(免鉴权)",
        "tags": [
          "static"
        ],
        "description": "",
        "security": [],
        "parameters": [
          {
            "name": "ipType",
            "in": "query",
            "required": true,
            "description": "静态 IP 类型，0 普通/广播，1 原生",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "totalIps",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "price",
            "in": "query",
            "required": false,
            "description": "服务端实时价格，示例数值不构成报价",
            "schema": {
              "type": "number"
            },
            "example": 5
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "countryCode",
            "in": "query",
            "required": false,
            "description": "两位国家/地区代码，例如 US、TH、GB",
            "schema": {
              "type": "string"
            },
            "example": "US"
          },
          {
            "name": "isExclusive",
            "in": "query",
            "required": false,
            "description": "资源类型标识，依实际购买配置使用",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "ipType": {
                            "type": "number"
                          },
                          "totalIps": {
                            "type": "number"
                          },
                          "price": {
                            "type": "number"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "isExclusive": {
                            "type": "number"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "ipType": 1,
                          "totalIps": 1,
                          "price": 5,
                          "countryCode": "US",
                          "status": "Y",
                          "merchantId": 1000,
                          "isExclusive": 1
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/static/continentConfig": {
      "get": {
        "operationId": "get-client-ip-static-continentConfig",
        "summary": "国家配置",
        "tags": [
          "static"
        ],
        "description": "地区配置字段随服务端配置变化；生产当前配置为空时，成功响应可省略 data。",
        "security": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "string"
                          },
                          "countries": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "code": {
                                  "type": "string"
                                },
                                "cities": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": [
                        {
                          "code": "Asia",
                          "countries": [
                            {
                              "code": "TH",
                              "cities": [
                                "Bangkok"
                              ]
                            }
                          ]
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/static/stats": {
      "get": {
        "operationId": "get-client-ip-static-stats",
        "summary": "静态IP统计",
        "tags": [
          "static"
        ],
        "description": "",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "confDaysCount": {
                          "type": "number"
                        },
                        "confNumCount": {
                          "type": "number"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "confDaysCount": 3,
                        "confNumCount": 4
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/pool/item/merchantIpList": {
      "get": {
        "operationId": "get-client-ip-pool-item-merchantIpList",
        "summary": "查询商户IP列表",
        "tags": [
          "static"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "静态 IP 类型，0 普通/广播，1 原生",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "ip",
            "in": "query",
            "required": false,
            "description": "代理 IP；示例使用 RFC 5737 文档地址",
            "schema": {
              "type": "string"
            },
            "example": "192.0.2.10"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "orderNo",
            "in": "query",
            "required": false,
            "description": "订单号，由下单接口返回",
            "schema": {
              "type": "string"
            },
            "example": "N2026101500000000001"
          },
          {
            "name": "countryCode",
            "in": "query",
            "required": false,
            "description": "两位国家/地区代码，例如 US、TH、GB",
            "schema": {
              "type": "string"
            },
            "example": "US"
          },
          {
            "name": "orderBy",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "orderDir",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "lastOrderId": {
                            "type": "number"
                          },
                          "lastPoolId": {
                            "type": "number"
                          },
                          "port": {
                            "type": "string"
                          },
                          "relayPort": {
                            "type": "string"
                          },
                          "remark": {
                            "type": "string"
                          },
                          "account": {
                            "type": "string"
                          },
                          "password": {
                            "type": "string"
                          },
                          "ip": {
                            "type": "string"
                          },
                          "protocolse": {
                            "type": "string"
                          },
                          "effectiveDatetime": {
                            "type": "string"
                          },
                          "expireDatetime": {
                            "type": "string"
                          },
                          "serviceExpireTime": {
                            "type": "string"
                          },
                          "unsubscribeTime": {
                            "nullable": true
                          },
                          "subscribeDatetime": {
                            "type": "string"
                          },
                          "status": {
                            "type": "number"
                          },
                          "autoRenewEnabled": {
                            "type": "number"
                          },
                          "poolId": {
                            "type": "number"
                          },
                          "type": {
                            "type": "number"
                          },
                          "continent": {
                            "type": "string"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "location": {
                            "type": "string"
                          },
                          "hot": {
                            "type": "string"
                          },
                          "updateTime": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "lastOrderId": 2001,
                          "lastPoolId": 3001,
                          "port": "62000",
                          "relayPort": "DEMO_VALUE",
                          "remark": "示例备注",
                          "account": "demo_account",
                          "password": "DEMO_PASSWORD",
                          "ip": "192.0.2.10",
                          "protocolse": "SOCKS5",
                          "effectiveDatetime": "2026-10-15 12:00:00",
                          "expireDatetime": "2026-11-14 12:00:00",
                          "serviceExpireTime": "2026-10-15 12:00:00",
                          "unsubscribeTime": null,
                          "subscribeDatetime": "2026-10-15 12:00:00",
                          "status": 1,
                          "autoRenewEnabled": 0,
                          "poolId": 3001,
                          "type": 1,
                          "continent": "North America",
                          "countryCode": "US",
                          "location": "United States",
                          "hot": "DEMO_VALUE",
                          "updateTime": "2026-10-15 12:00:00"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/pool/item/updateCreds": {
      "post": {
        "operationId": "post-client-ip-pool-item-updateCreds",
        "summary": "修改IP账密",
        "tags": [
          "static"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ip": {
                    "type": "string"
                  },
                  "account": {
                    "type": "string"
                  },
                  "password": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "ip": "192.0.2.10",
                "account": "demo_account",
                "password": "DEMO_PASSWORD"
              }
            }
          }
        }
      }
    },
    "/client/ip/pool/item/autoRenew": {
      "post": {
        "operationId": "post-client-ip-pool-item-autoRenew",
        "summary": "更新静态IP自动续费开关",
        "tags": [
          "static"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "number"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "自动续费已开启",
                      "data": 1
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ipList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "autoRenewEnabled": {
                    "type": "number"
                  }
                }
              },
              "example": {
                "ipList": [
                  "192.0.2.10"
                ],
                "autoRenewEnabled": 1
              }
            }
          }
        }
      }
    },
    "/client/ip/pool/item/remark": {
      "post": {
        "operationId": "post-client-ip-pool-item-remark",
        "summary": "更新IP备注",
        "tags": [
          "static"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ip": {
                    "type": "string"
                  },
                  "remark": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "ip": "192.0.2.10",
                "remark": "demo-team"
              }
            }
          }
        }
      }
    },
    "/client/ip/pool/item/proxySpeedTest/batch": {
      "post": {
        "operationId": "post-client-ip-pool-item-proxySpeedTest-batch",
        "summary": "批量代理连通检测",
        "tags": [
          "static"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n每条代理的结果在 data 数组；单条失败不会自动将顶层 code 改为失败。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "line": {
                            "type": "string"
                          },
                          "protocol": {
                            "type": "string"
                          },
                          "ok": {
                            "type": "boolean"
                          },
                          "connectMs": {
                            "type": "number"
                          },
                          "error": {
                            "nullable": true
                          },
                          "ipInfoJson": {
                            "type": "string"
                          },
                          "ipSummary": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": [
                        {
                          "line": "socks5://demo_account:DEMO_PASSWORD@192.0.2.10:62000",
                          "protocol": "socks5",
                          "ok": true,
                          "connectMs": 160,
                          "error": null,
                          "ipInfoJson": "{\"ip\":\"192.0.2.10\",\"country\":\"US\"}",
                          "ipSummary": "192.0.2.10 / US"
                        }
                      ]
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "lines": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              },
              "example": {
                "lines": [
                  "socks5://demo_account:DEMO_PASSWORD@192.0.2.10:62000"
                ]
              }
            }
          }
        }
      }
    },
    "/client/ip/pool/item/proxySpeedTest/row": {
      "post": {
        "operationId": "post-client-ip-pool-item-proxySpeedTest-row",
        "summary": "单条 HTTP + SOCKS5 连通检测",
        "tags": [
          "static"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n同时检查 HTTP 和 SOCKS5；业务 code=200 仅表示检测执行成功，是否连通须检查 httpOk/socks5Ok。",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；检测执行成功，但代理连接失败；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "ip": {
                          "type": "string"
                        },
                        "port": {
                          "type": "number"
                        },
                        "httpOk": {
                          "type": "boolean"
                        },
                        "httpMs": {
                          "type": "number"
                        },
                        "httpError": {
                          "nullable": true
                        },
                        "httpIpInfoJson": {
                          "type": "string"
                        },
                        "socks5Ok": {
                          "type": "boolean"
                        },
                        "socks5Ms": {
                          "type": "number"
                        },
                        "socks5Error": {
                          "nullable": true
                        },
                        "socks5IpInfoJson": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "ip": "192.0.2.10",
                        "port": 62000,
                        "httpOk": true,
                        "httpMs": 180,
                        "httpError": null,
                        "httpIpInfoJson": "{\"ip\":\"192.0.2.10\",\"country\":\"US\"}",
                        "socks5Ok": true,
                        "socks5Ms": 160,
                        "socks5Error": null,
                        "socks5IpInfoJson": "{\"ip\":\"192.0.2.10\",\"country\":\"US\"}"
                      }
                    }
                  },
                  "example_2": {
                    "summary": "检测执行成功，但代理连接失败",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "ip": "192.0.2.10",
                        "port": 62000,
                        "httpOk": false,
                        "httpMs": null,
                        "httpError": "Connection timed out",
                        "httpIpInfoJson": null,
                        "socks5Ok": false,
                        "socks5Ms": null,
                        "socks5Error": "Connection timed out",
                        "socks5IpInfoJson": null
                      }
                    }
                  },
                  "example_4": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ip": {
                    "type": "string"
                  },
                  "port": {
                    "type": "string"
                  },
                  "account": {
                    "type": "string"
                  },
                  "password": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "ip": "192.0.2.10",
                "port": "62000",
                "account": "demo_account",
                "password": "DEMO_PASSWORD"
              }
            }
          }
        }
      }
    },
    "/client/ip/source/sourceIpList": {
      "get": {
        "operationId": "get-client-ip-source-sourceIpList",
        "summary": "merchantIpList",
        "tags": [
          "static"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "静态 IP 类型，0 普通/广播，1 原生",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "ip",
            "in": "query",
            "required": false,
            "description": "代理 IP；示例使用 RFC 5737 文档地址",
            "schema": {
              "type": "string"
            },
            "example": "192.0.2.10"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "orderNo",
            "in": "query",
            "required": false,
            "description": "订单号，由下单接口返回",
            "schema": {
              "type": "string"
            },
            "example": "N2026101500000000001"
          },
          {
            "name": "countryCode",
            "in": "query",
            "required": false,
            "description": "两位国家/地区代码，例如 US、TH、GB",
            "schema": {
              "type": "string"
            },
            "example": "US"
          },
          {
            "name": "orderBy",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "orderDir",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "lastOrderId": {
                            "type": "number"
                          },
                          "lastPoolId": {
                            "type": "number"
                          },
                          "port": {
                            "type": "string"
                          },
                          "relayPort": {
                            "type": "string"
                          },
                          "remark": {
                            "type": "string"
                          },
                          "account": {
                            "type": "string"
                          },
                          "password": {
                            "type": "string"
                          },
                          "ip": {
                            "type": "string"
                          },
                          "protocolse": {
                            "type": "string"
                          },
                          "effectiveDatetime": {
                            "type": "string"
                          },
                          "expireDatetime": {
                            "type": "string"
                          },
                          "serviceExpireTime": {
                            "type": "string"
                          },
                          "unsubscribeTime": {
                            "nullable": true
                          },
                          "subscribeDatetime": {
                            "type": "string"
                          },
                          "status": {
                            "type": "number"
                          },
                          "autoRenewEnabled": {
                            "type": "number"
                          },
                          "poolId": {
                            "type": "number"
                          },
                          "type": {
                            "type": "number"
                          },
                          "continent": {
                            "type": "string"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "location": {
                            "type": "string"
                          },
                          "hot": {
                            "type": "string"
                          },
                          "updateTime": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "lastOrderId": 2001,
                          "lastPoolId": 3001,
                          "port": "62000",
                          "relayPort": "DEMO_VALUE",
                          "remark": "示例备注",
                          "account": "demo_account",
                          "password": "DEMO_PASSWORD",
                          "ip": "192.0.2.10",
                          "protocolse": "SOCKS5",
                          "effectiveDatetime": "2026-10-15 12:00:00",
                          "expireDatetime": "2026-11-14 12:00:00",
                          "serviceExpireTime": "2026-10-15 12:00:00",
                          "unsubscribeTime": null,
                          "subscribeDatetime": "2026-10-15 12:00:00",
                          "status": 1,
                          "autoRenewEnabled": 0,
                          "poolId": 3001,
                          "type": 1,
                          "continent": "North America",
                          "countryCode": "US",
                          "location": "United States",
                          "hot": "DEMO_VALUE",
                          "updateTime": "2026-10-15 12:00:00"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/pool/list": {
      "get": {
        "operationId": "get-client-ip-pool-list",
        "summary": "查询静态IP-IP池列表",
        "tags": [
          "static"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "静态 IP 类型，0 普通/广播，1 原生",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "sourceCode",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "sourceName",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "continent",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "North America"
          },
          {
            "name": "countryCode",
            "in": "query",
            "required": false,
            "description": "两位国家/地区代码，例如 US、TH、GB",
            "schema": {
              "type": "string"
            },
            "example": "US"
          },
          {
            "name": "location",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "United States"
          },
          {
            "name": "hot",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "isExclusive",
            "in": "query",
            "required": false,
            "description": "资源类型标识，依实际购买配置使用",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "type": {
                            "type": "number"
                          },
                          "continent": {
                            "type": "string"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "location": {
                            "type": "string"
                          },
                          "hot": {
                            "type": "string"
                          },
                          "status": {
                            "type": "number"
                          },
                          "ipTotals": {
                            "type": "number"
                          },
                          "effectiveTotals": {
                            "type": "number"
                          },
                          "configPlans": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "number"
                                },
                                "ipType": {
                                  "type": "number"
                                },
                                "totalIps": {
                                  "type": "number"
                                },
                                "price": {
                                  "type": "number"
                                },
                                "countryCode": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "merchantId": {
                                  "type": "number"
                                },
                                "isExclusive": {
                                  "type": "number"
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "type": 1,
                          "continent": "North America",
                          "countryCode": "US",
                          "location": "United States",
                          "hot": "DEMO_VALUE",
                          "status": 1,
                          "ipTotals": 10,
                          "effectiveTotals": 1,
                          "configPlans": [
                            {
                              "id": 1001,
                              "ipType": 1,
                              "totalIps": 1,
                              "price": 5,
                              "countryCode": "US",
                              "status": "Y",
                              "merchantId": 1000,
                              "isExclusive": 1
                            }
                          ]
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/pool/regionalAvailableIps": {
      "get": {
        "operationId": "get-client-ip-pool-regionalAvailableIps",
        "summary": "查询静态IP-可用IP列表(支持多选)",
        "tags": [
          "static"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "静态 IP 类型，0 普通/广播，1 原生",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "continents",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "DEMO_VALUE"
            ]
          },
          {
            "name": "countryCodes",
            "in": "query",
            "required": false,
            "description": "国家代码数组，查询参数可重复传入",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "US",
              "TH"
            ]
          },
          {
            "name": "locations",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "DEMO_VALUE"
            ]
          },
          {
            "name": "isExclusive",
            "in": "query",
            "required": false,
            "description": "资源类型标识，依实际购买配置使用",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "type": {
                            "type": "number"
                          },
                          "continent": {
                            "type": "string"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "location": {
                            "type": "string"
                          },
                          "price": {
                            "type": "number"
                          },
                          "ipTotals": {
                            "type": "number"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "type": 1,
                          "continent": "North America",
                          "countryCode": "US",
                          "location": "United States",
                          "price": 5,
                          "ipTotals": 10
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/ip/pool/remote/list": {
      "get": {
        "operationId": "get-client-ip-pool-remote-list",
        "summary": "查询可用资源池IP列表（客户端购买指定IP）",
        "tags": [
          "static"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "ip",
            "in": "query",
            "required": false,
            "description": "代理 IP；示例使用 RFC 5737 文档地址",
            "schema": {
              "type": "string"
            },
            "example": "192.0.2.10"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "状态值依对象而异；静态资源 1 有效、2 过期、3 取消",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "countryCode",
            "in": "query",
            "required": false,
            "description": "两位国家/地区代码，例如 US、TH、GB",
            "schema": {
              "type": "string"
            },
            "example": "US"
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；无记录时（示例）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "ip": {
                            "type": "string"
                          },
                          "port": {
                            "type": "string"
                          },
                          "status": {
                            "type": "number"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "location": {
                            "type": "string"
                          },
                          "continent": {
                            "type": "string"
                          },
                          "sourceName": {
                            "type": "string"
                          },
                          "sourceCode": {
                            "type": "string"
                          },
                          "isSelfOwned": {
                            "type": "boolean"
                          },
                          "serverId": {
                            "type": "number"
                          },
                          "serverName": {
                            "type": "string"
                          },
                          "serverIp": {
                            "type": "string"
                          },
                          "serverPort": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": [
                        {
                          "id": 1001,
                          "ip": "192.0.2.10",
                          "port": "62000",
                          "status": 1,
                          "countryCode": "US",
                          "location": "United States",
                          "continent": "North America",
                          "sourceName": "DEMO_VALUE",
                          "sourceCode": "DEMO_VALUE",
                          "isSelfOwned": false,
                          "serverId": 1,
                          "serverName": "DEMO_VALUE",
                          "serverIp": "DEMO_VALUE",
                          "serverPort": "DEMO_VALUE"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "无记录时（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/order/addStatic": {
      "post": {
        "operationId": "post-client-order-addStatic",
        "summary": "客户端下单静态IP (只下单，不支付)",
        "tags": [
          "shared"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n这里只创建待支付订单，不会直接扣款或保证交付。金额和库存由服务端核验。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "订单创建成功，请在30分钟内支付",
                      "data": "N2026101500000000001"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "payMode": {
                    "type": "string"
                  },
                  "payMethod": {
                    "type": "string"
                  },
                  "currency": {
                    "type": "string"
                  },
                  "monthCount": {
                    "type": "number"
                  },
                  "isExclusive": {
                    "type": "number"
                  },
                  "countryNums": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "countryCode": {
                          "type": "string"
                        },
                        "location": {
                          "type": "string"
                        },
                        "num": {
                          "type": "number"
                        },
                        "ipType": {
                          "type": "number"
                        }
                      }
                    }
                  }
                }
              },
              "example": {
                "payMode": "PAY_FIRST",
                "payMethod": "BALANCE",
                "currency": "USD",
                "monthCount": 1,
                "isExclusive": 1,
                "countryNums": [
                  {
                    "countryCode": "US",
                    "location": "United States",
                    "num": 1,
                    "ipType": 1
                  }
                ]
              }
            }
          }
        }
      }
    },
    "/client/order/addDynamics": {
      "post": {
        "operationId": "post-client-order-addDynamics",
        "summary": "客户端下单动态IP",
        "tags": [
          "shared"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "订单创建成功，请在30分钟内支付",
                      "data": "N2026101500000000001"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "configPlanId": {
                    "type": "number"
                  },
                  "configPeriodId": {
                    "type": "number"
                  },
                  "capacity": {
                    "type": "number"
                  },
                  "days": {
                    "type": "number"
                  },
                  "currency": {
                    "type": "string"
                  },
                  "payMode": {
                    "type": "string"
                  },
                  "payMethod": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "configPlanId": 12,
                "configPeriodId": 3,
                "capacity": 10,
                "days": 30,
                "currency": "USD",
                "payMode": "PAY_FIRST",
                "payMethod": "BALANCE"
              }
            }
          }
        }
      }
    },
    "/client/order/regionalAvailableIps": {
      "get": {
        "operationId": "get-client-order-regionalAvailableIps",
        "summary": "查询静态IP资源池(获取出口IP)",
        "tags": [
          "shared"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "静态 IP 类型，0 普通/广播，1 原生",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "continents",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "DEMO_VALUE"
            ]
          },
          {
            "name": "countryCodes",
            "in": "query",
            "required": false,
            "description": "国家代码数组，查询参数可重复传入",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "US",
              "TH"
            ]
          },
          {
            "name": "locations",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "DEMO_VALUE"
            ]
          },
          {
            "name": "ipFuzzyField",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "isExclusive",
            "in": "query",
            "required": false,
            "description": "资源类型标识，依实际购买配置使用",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "type": {
                            "type": "number"
                          },
                          "continent": {
                            "type": "string"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "location": {
                            "type": "string"
                          },
                          "price": {
                            "type": "number"
                          },
                          "ipTotals": {
                            "type": "number"
                          },
                          "effectiveTotals": {
                            "type": "number"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "type": 1,
                          "continent": "North America",
                          "countryCode": "US",
                          "location": "United States",
                          "price": 5,
                          "ipTotals": 10,
                          "effectiveTotals": 1
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/order/dataStatistics": {
      "get": {
        "operationId": "get-client-order-dataStatistics",
        "summary": "数据统计",
        "tags": [
          "shared"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "nextPayDays": {
                          "type": "number"
                        },
                        "regularipTotal": {
                          "type": "number"
                        },
                        "regularExpiringSoon": {
                          "type": "number"
                        },
                        "premiumIpTotal": {
                          "type": "number"
                        },
                        "premiumExpiringSoon": {
                          "type": "number"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "nextPayDays": 30,
                        "regularipTotal": 1,
                        "regularExpiringSoon": 0,
                        "premiumIpTotal": 1,
                        "premiumExpiringSoon": 0
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/order/orderList": {
      "get": {
        "operationId": "get-client-order-orderList",
        "summary": "订单列表",
        "tags": [
          "shared"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "productName",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "orderNo",
            "in": "query",
            "required": false,
            "description": "订单号，由下单接口返回",
            "schema": {
              "type": "string"
            },
            "example": "N2026101500000000001"
          },
          {
            "name": "domain",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "DEMO_VALUE"
          },
          {
            "name": "productType",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "orderNo": {
                            "type": "string"
                          },
                          "domain": {
                            "type": "string"
                          },
                          "productName": {
                            "type": "string"
                          },
                          "productType": {
                            "type": "number"
                          },
                          "quantity": {
                            "type": "number"
                          },
                          "originalAmount": {
                            "type": "number"
                          },
                          "totalAmount": {
                            "type": "number"
                          },
                          "discountAmount": {
                            "type": "number"
                          },
                          "couponCode": {
                            "type": "string"
                          },
                          "couponName": {
                            "type": "string"
                          },
                          "couponType": {
                            "type": "string"
                          },
                          "couponValue": {
                            "type": "number"
                          },
                          "currency": {
                            "type": "string"
                          },
                          "status": {
                            "type": "number"
                          },
                          "paidStatus": {
                            "type": "number"
                          },
                          "payMethod": {
                            "type": "string"
                          },
                          "payMode": {
                            "type": "string"
                          },
                          "totalIps": {
                            "type": "number"
                          },
                          "udp": {
                            "type": "string"
                          },
                          "staticCountryNums": {
                            "type": "string"
                          },
                          "effectiveDatetime": {
                            "type": "string"
                          },
                          "expireDatetime": {
                            "type": "string"
                          },
                          "nextNotifyTime": {
                            "type": "string"
                          },
                          "notifyCount": {
                            "type": "number"
                          },
                          "orderItems": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "number"
                                },
                                "orderId": {
                                  "type": "number"
                                },
                                "orderType": {
                                  "type": "number"
                                },
                                "poolId": {
                                  "type": "number"
                                },
                                "price": {
                                  "type": "number"
                                },
                                "currency": {
                                  "type": "string"
                                },
                                "days": {
                                  "type": "number"
                                },
                                "discount": {
                                  "type": "number"
                                },
                                "continent": {
                                  "type": "string"
                                },
                                "countryCode": {
                                  "type": "string"
                                },
                                "location": {
                                  "type": "string"
                                },
                                "ip": {
                                  "type": "string"
                                },
                                "protocolse": {
                                  "type": "string"
                                },
                                "effectiveDatetime": {
                                  "type": "string"
                                },
                                "expireDatetime": {
                                  "type": "string"
                                },
                                "unsubscribeTime": {
                                  "nullable": true
                                },
                                "account": {
                                  "type": "string"
                                },
                                "password": {
                                  "type": "string"
                                },
                                "port": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                }
                              }
                            }
                          },
                          "staticIp": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "orderNo": "N2026101500000000001",
                          "domain": "DEMO_VALUE",
                          "productName": "DEMO_VALUE",
                          "productType": 1,
                          "quantity": 1,
                          "originalAmount": 1.0,
                          "totalAmount": 5,
                          "discountAmount": 1.0,
                          "couponCode": "",
                          "couponName": "DEMO_VALUE",
                          "couponType": "DEMO_VALUE",
                          "couponValue": 1.0,
                          "currency": "USD",
                          "status": 1,
                          "paidStatus": 10,
                          "payMethod": "BALANCE",
                          "payMode": "PAY_FIRST",
                          "totalIps": 1,
                          "udp": "DEMO_VALUE",
                          "staticCountryNums": "DEMO_VALUE",
                          "effectiveDatetime": "2026-10-15 12:00:00",
                          "expireDatetime": "2026-11-14 12:00:00",
                          "nextNotifyTime": "2026-10-15 12:00:00",
                          "notifyCount": 1,
                          "orderItems": [
                            {
                              "id": 1001,
                              "orderId": 2001,
                              "orderType": 1,
                              "poolId": 3001,
                              "price": 5,
                              "currency": "USD",
                              "days": 30,
                              "discount": 1,
                              "continent": "North America",
                              "countryCode": "US",
                              "location": "United States",
                              "ip": "192.0.2.10",
                              "protocolse": "SOCKS5",
                              "effectiveDatetime": "2026-10-15 12:00:00",
                              "expireDatetime": "2026-11-14 12:00:00",
                              "unsubscribeTime": null,
                              "account": "demo_account",
                              "password": "DEMO_PASSWORD",
                              "port": "62000",
                              "status": "Y"
                            }
                          ],
                          "staticIp": "DEMO_VALUE"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/order/orderDetail/{orderId}": {
      "get": {
        "operationId": "get-client-order-orderDetail-orderId",
        "summary": "订单详情",
        "tags": [
          "shared"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "description": "订单 ID，不是订单号字符串",
            "schema": {
              "type": "number"
            },
            "example": 2001
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "number"
                        },
                        "merchantId": {
                          "type": "number"
                        },
                        "orderNo": {
                          "type": "string"
                        },
                        "domain": {
                          "type": "string"
                        },
                        "productName": {
                          "type": "string"
                        },
                        "productType": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "number"
                        },
                        "originalAmount": {
                          "type": "number"
                        },
                        "totalAmount": {
                          "type": "number"
                        },
                        "discountAmount": {
                          "type": "number"
                        },
                        "couponCode": {
                          "type": "string"
                        },
                        "couponName": {
                          "type": "string"
                        },
                        "couponType": {
                          "type": "string"
                        },
                        "couponValue": {
                          "type": "number"
                        },
                        "currency": {
                          "type": "string"
                        },
                        "status": {
                          "type": "number"
                        },
                        "paidStatus": {
                          "type": "number"
                        },
                        "payMethod": {
                          "type": "string"
                        },
                        "payMode": {
                          "type": "string"
                        },
                        "totalIps": {
                          "type": "number"
                        },
                        "udp": {
                          "type": "string"
                        },
                        "staticCountryNums": {
                          "type": "string"
                        },
                        "effectiveDatetime": {
                          "type": "string"
                        },
                        "expireDatetime": {
                          "type": "string"
                        },
                        "nextNotifyTime": {
                          "type": "string"
                        },
                        "notifyCount": {
                          "type": "number"
                        },
                        "orderItems": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "number"
                              },
                              "orderId": {
                                "type": "number"
                              },
                              "orderType": {
                                "type": "number"
                              },
                              "poolId": {
                                "type": "number"
                              },
                              "price": {
                                "type": "number"
                              },
                              "currency": {
                                "type": "string"
                              },
                              "days": {
                                "type": "number"
                              },
                              "discount": {
                                "type": "number"
                              },
                              "continent": {
                                "type": "string"
                              },
                              "countryCode": {
                                "type": "string"
                              },
                              "location": {
                                "type": "string"
                              },
                              "ip": {
                                "type": "string"
                              },
                              "protocolse": {
                                "type": "string"
                              },
                              "effectiveDatetime": {
                                "type": "string"
                              },
                              "expireDatetime": {
                                "type": "string"
                              },
                              "unsubscribeTime": {
                                "nullable": true
                              },
                              "account": {
                                "type": "string"
                              },
                              "password": {
                                "type": "string"
                              },
                              "port": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "staticIp": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "id": 1001,
                        "merchantId": 1000,
                        "orderNo": "N2026101500000000001",
                        "domain": "DEMO_VALUE",
                        "productName": "DEMO_VALUE",
                        "productType": 1,
                        "quantity": 1,
                        "originalAmount": 1.0,
                        "totalAmount": 5,
                        "discountAmount": 1.0,
                        "couponCode": "",
                        "couponName": "DEMO_VALUE",
                        "couponType": "DEMO_VALUE",
                        "couponValue": 1.0,
                        "currency": "USD",
                        "status": 1,
                        "paidStatus": 10,
                        "payMethod": "BALANCE",
                        "payMode": "PAY_FIRST",
                        "totalIps": 1,
                        "udp": "DEMO_VALUE",
                        "staticCountryNums": "DEMO_VALUE",
                        "effectiveDatetime": "2026-10-15 12:00:00",
                        "expireDatetime": "2026-11-14 12:00:00",
                        "nextNotifyTime": "2026-10-15 12:00:00",
                        "notifyCount": 1,
                        "orderItems": [
                          {
                            "id": 1001,
                            "orderId": 2001,
                            "orderType": 1,
                            "poolId": 3001,
                            "price": 5,
                            "currency": "USD",
                            "days": 30,
                            "discount": 1,
                            "continent": "North America",
                            "countryCode": "US",
                            "location": "United States",
                            "ip": "192.0.2.10",
                            "protocolse": "SOCKS5",
                            "effectiveDatetime": "2026-10-15 12:00:00",
                            "expireDatetime": "2026-11-14 12:00:00",
                            "unsubscribeTime": null,
                            "account": "demo_account",
                            "password": "DEMO_PASSWORD",
                            "port": "62000",
                            "status": "Y"
                          }
                        ],
                        "staticIp": "DEMO_VALUE"
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/order/continuePay/{orderNo}": {
      "post": {
        "operationId": "post-client-order-continuePay-orderNo",
        "summary": "继续支付待支付订单",
        "tags": [
          "shared"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "orderNo",
            "in": "path",
            "required": true,
            "description": "订单号，由下单接口返回",
            "schema": {
              "type": "string"
            },
            "example": "N2026101500000000001"
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "orderNo": {
                          "type": "string"
                        },
                        "orderId": {
                          "type": "number"
                        },
                        "amount": {
                          "type": "number"
                        },
                        "totalAmount": {
                          "type": "number"
                        },
                        "paidStatus": {
                          "type": "number"
                        },
                        "productType": {
                          "type": "number"
                        },
                        "paid": {
                          "type": "boolean"
                        },
                        "paymentType": {
                          "type": "string"
                        },
                        "paymentName": {
                          "type": "string"
                        },
                        "payUrl": {
                          "type": "string"
                        },
                        "sessionId": {
                          "type": "string"
                        },
                        "clientSecret": {
                          "type": "string"
                        },
                        "currency": {
                          "type": "string"
                        },
                        "countryCode": {
                          "type": "string"
                        },
                        "successUrl": {
                          "type": "string"
                        },
                        "airwallexEnv": {
                          "type": "string"
                        },
                        "status": {
                          "type": "number"
                        },
                        "payMessage": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "orderNo": "N2026101500000000001",
                        "orderId": 2001,
                        "amount": 5,
                        "totalAmount": 5,
                        "paidStatus": 10,
                        "productType": 1,
                        "paid": false,
                        "paymentType": "STRIPE",
                        "paymentName": "余额支付",
                        "payUrl": "https://checkout.example.invalid/demo",
                        "sessionId": "cs_DEMO_SESSION",
                        "clientSecret": "DEMO_VALUE",
                        "currency": "USD",
                        "countryCode": "US",
                        "successUrl": "DEMO_VALUE",
                        "airwallexEnv": "DEMO_VALUE",
                        "status": 0,
                        "payMessage": "checkout_created"
                      }
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "payment": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "payment": "STRIPE"
              }
            }
          }
        }
      }
    },
    "/client/order/cancel/{orderNo}": {
      "post": {
        "operationId": "post-client-order-cancel-orderNo",
        "summary": "取消待支付订单",
        "tags": [
          "shared"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "orderNo",
            "in": "path",
            "required": true,
            "description": "订单号，由下单接口返回",
            "schema": {
              "type": "string"
            },
            "example": "N2026101500000000001"
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "boolean"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": true
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/order/purchasedList": {
      "get": {
        "operationId": "get-client-order-purchasedList",
        "summary": "已购买IP详情列表",
        "tags": [
          "shared"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "continent",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "North America"
          },
          {
            "name": "countryCode",
            "in": "query",
            "required": false,
            "description": "两位国家/地区代码，例如 US、TH、GB",
            "schema": {
              "type": "string"
            },
            "example": "US"
          },
          {
            "name": "location",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "string"
            },
            "example": "United States"
          },
          {
            "name": "ip",
            "in": "query",
            "required": false,
            "description": "代理 IP；示例使用 RFC 5737 文档地址",
            "schema": {
              "type": "string"
            },
            "example": "192.0.2.10"
          },
          {
            "name": "port",
            "in": "query",
            "required": false,
            "description": "代理端口，读取资源返回值，不固定写死",
            "schema": {
              "type": "string"
            },
            "example": "62000"
          },
          {
            "name": "orderType",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数",
            "schema": {
              "type": "number"
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；空列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "orderId": {
                            "type": "number"
                          },
                          "orderType": {
                            "type": "number"
                          },
                          "poolId": {
                            "type": "number"
                          },
                          "price": {
                            "type": "number"
                          },
                          "currency": {
                            "type": "string"
                          },
                          "days": {
                            "type": "number"
                          },
                          "discount": {
                            "type": "number"
                          },
                          "continent": {
                            "type": "string"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "location": {
                            "type": "string"
                          },
                          "ip": {
                            "type": "string"
                          },
                          "protocolse": {
                            "type": "string"
                          },
                          "effectiveDatetime": {
                            "type": "string"
                          },
                          "expireDatetime": {
                            "type": "string"
                          },
                          "unsubscribeTime": {
                            "nullable": true
                          },
                          "account": {
                            "type": "string"
                          },
                          "password": {
                            "type": "string"
                          },
                          "port": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "orderNo": {
                            "type": "string"
                          },
                          "domain": {
                            "type": "string"
                          },
                          "productName": {
                            "type": "string"
                          },
                          "productType": {
                            "type": "number"
                          },
                          "quantity": {
                            "type": "number"
                          },
                          "totalAmount": {
                            "type": "number"
                          },
                          "paidStatus": {
                            "type": "number"
                          },
                          "payMethod": {
                            "type": "string"
                          },
                          "totalIps": {
                            "type": "number"
                          },
                          "udp": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 1,
                      "rows": [
                        {
                          "id": 1001,
                          "orderId": 2001,
                          "orderType": 1,
                          "poolId": 3001,
                          "price": 5,
                          "currency": "USD",
                          "days": 30,
                          "discount": 1,
                          "continent": "North America",
                          "countryCode": "US",
                          "location": "United States",
                          "ip": "192.0.2.10",
                          "protocolse": "SOCKS5",
                          "effectiveDatetime": "2026-10-15 12:00:00",
                          "expireDatetime": "2026-11-14 12:00:00",
                          "unsubscribeTime": null,
                          "account": "demo_account",
                          "password": "DEMO_PASSWORD",
                          "port": "62000",
                          "status": "Y",
                          "merchantId": 1000,
                          "orderNo": "N2026101500000000001",
                          "domain": "DEMO_VALUE",
                          "productName": "DEMO_VALUE",
                          "productType": 1,
                          "quantity": 1,
                          "totalAmount": 5,
                          "paidStatus": 10,
                          "payMethod": "BALANCE",
                          "totalIps": 1,
                          "udp": "DEMO_VALUE"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "空列表",
                    "value": {
                      "code": 200,
                      "msg": "查询成功",
                      "total": 0,
                      "rows": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/order/beenPurchased": {
      "get": {
        "operationId": "get-client-order-beenPurchased",
        "summary": "是否已购买",
        "tags": [
          "shared"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "productType",
            "in": "query",
            "required": false,
            "description": "返回模型字段",
            "schema": {
              "type": "number"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "boolean"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": true
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/order/renewIpList": {
      "post": {
        "operationId": "post-client-order-renewIpList",
        "summary": "续费IP (Item模式)",
        "tags": [
          "shared"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n续费生成待支付订单，data 是订单号。1 个月延长 30 天；后续仍需确认支付与资源交付状态。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "订单创建成功，请在30分钟内支付",
                      "data": "N2026101500000000001"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ipList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "monthCount": {
                    "type": "number"
                  }
                }
              },
              "example": {
                "ipList": [
                  "192.0.2.10"
                ],
                "monthCount": 1
              }
            }
          }
        }
      }
    },
    "/client/order/renewStatic": {
      "post": {
        "operationId": "post-client-order-renewStatic",
        "summary": "续费静态IP (Order模式)",
        "tags": [
          "shared"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n续费生成待支付订单，data 是订单号。1 个月延长 30 天；后续仍需确认支付与资源交付状态。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "订单创建成功，请在30分钟内支付",
                      "data": "N2026101500000000001"
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ipList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "monthCount": {
                    "type": "number"
                  }
                }
              },
              "example": {
                "ipList": [
                  "192.0.2.10"
                ],
                "monthCount": 1
              }
            }
          }
        }
      }
    },
    "/client/order/getMerchantIpsByOrderNo": {
      "get": {
        "operationId": "get-client-order-getMerchantIpsByOrderNo",
        "summary": "按订单号查询交付 IP",
        "tags": [
          "shared"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "orderNo",
            "in": "query",
            "required": true,
            "description": "订单号，由下单接口返回",
            "schema": {
              "type": "string"
            },
            "example": "N2026101500000000001"
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；无记录时（示例）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "number"
                          },
                          "merchantId": {
                            "type": "number"
                          },
                          "lastOrderId": {
                            "type": "number"
                          },
                          "lastPoolId": {
                            "type": "number"
                          },
                          "port": {
                            "type": "string"
                          },
                          "relayPort": {
                            "type": "string"
                          },
                          "remark": {
                            "type": "string"
                          },
                          "account": {
                            "type": "string"
                          },
                          "password": {
                            "type": "string"
                          },
                          "ip": {
                            "type": "string"
                          },
                          "protocolse": {
                            "type": "string"
                          },
                          "effectiveDatetime": {
                            "type": "string"
                          },
                          "expireDatetime": {
                            "type": "string"
                          },
                          "serviceExpireTime": {
                            "type": "string"
                          },
                          "unsubscribeTime": {
                            "nullable": true
                          },
                          "subscribeDatetime": {
                            "type": "string"
                          },
                          "status": {
                            "type": "number"
                          },
                          "autoRenewEnabled": {
                            "type": "number"
                          },
                          "poolId": {
                            "type": "number"
                          },
                          "type": {
                            "type": "number"
                          },
                          "continent": {
                            "type": "string"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "location": {
                            "type": "string"
                          },
                          "hot": {
                            "type": "string"
                          },
                          "updateTime": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": [
                        {
                          "id": 1001,
                          "merchantId": 1000,
                          "lastOrderId": 2001,
                          "lastPoolId": 3001,
                          "port": "62000",
                          "relayPort": "DEMO_VALUE",
                          "remark": "示例备注",
                          "account": "demo_account",
                          "password": "DEMO_PASSWORD",
                          "ip": "192.0.2.10",
                          "protocolse": "SOCKS5",
                          "effectiveDatetime": "2026-10-15 12:00:00",
                          "expireDatetime": "2026-11-14 12:00:00",
                          "serviceExpireTime": "2026-10-15 12:00:00",
                          "unsubscribeTime": null,
                          "subscribeDatetime": "2026-10-15 12:00:00",
                          "status": 1,
                          "autoRenewEnabled": 0,
                          "poolId": 3001,
                          "type": 1,
                          "continent": "North America",
                          "countryCode": "US",
                          "location": "United States",
                          "hot": "DEMO_VALUE",
                          "updateTime": "2026-10-15 12:00:00"
                        }
                      ]
                    }
                  },
                  "example_2": {
                    "summary": "无记录时（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": []
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/payment/order/pay/{orderNo}": {
      "post": {
        "operationId": "post-client-payment-order-pay-orderNo",
        "summary": "订单支付",
        "tags": [
          "shared"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。\n余额支付成功与外部收银台创建成功不同；跳转 URL 不是付款证明。请重新查询订单和 IP/流量资源。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "orderNo",
            "in": "path",
            "required": true,
            "description": "订单号，由下单接口返回",
            "schema": {
              "type": "string"
            },
            "example": "N2026101500000000001"
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；外部收银台创建成功，尚未付款；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "paymentType": {
                          "type": "string"
                        },
                        "paymentName": {
                          "type": "string"
                        },
                        "orderId": {
                          "type": "number"
                        },
                        "orderNo": {
                          "type": "string"
                        },
                        "amount": {
                          "type": "number"
                        },
                        "totalAmount": {
                          "type": "number"
                        },
                        "currency": {
                          "type": "string"
                        },
                        "productType": {
                          "type": "number"
                        },
                        "paidStatus": {
                          "type": "number"
                        },
                        "paid": {
                          "type": "boolean"
                        },
                        "status": {
                          "type": "number"
                        },
                        "payMessage": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "paymentType": "BALANCE",
                        "paymentName": "余额支付",
                        "orderId": 2001,
                        "orderNo": "N2026101500000000001",
                        "amount": 5,
                        "totalAmount": 5,
                        "currency": "USD",
                        "productType": 1,
                        "paidStatus": 20,
                        "paid": true,
                        "status": 1,
                        "payMessage": "success"
                      }
                    }
                  },
                  "example_2": {
                    "summary": "外部收银台创建成功，尚未付款",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "orderNo": "N2026101500000000001",
                        "orderId": 2001,
                        "amount": 5,
                        "totalAmount": 5,
                        "paidStatus": 10,
                        "productType": 1,
                        "paid": false,
                        "paymentType": "STRIPE",
                        "paymentName": "余额支付",
                        "payUrl": "https://checkout.example.invalid/demo",
                        "sessionId": "cs_DEMO_SESSION",
                        "clientSecret": "DEMO_VALUE",
                        "currency": "USD",
                        "countryCode": "US",
                        "successUrl": "DEMO_VALUE",
                        "airwallexEnv": "DEMO_VALUE",
                        "status": 0,
                        "payMessage": "checkout_created"
                      }
                    }
                  },
                  "example_4": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "余额不足"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "payment": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "payment": "BALANCE"
              }
            }
          }
        }
      }
    },
    "/client/payment/order/epaySync/{orderNo}": {
      "post": {
        "operationId": "post-client-payment-order-epaySync-orderNo",
        "summary": "Epay order payment sync confirmation",
        "tags": [
          "shared"
        ],
        "description": "此接口会修改数据或创建业务记录。文档只展示代码，不会自动发送请求。",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [
          {
            "name": "orderNo",
            "in": "path",
            "required": true,
            "description": "订单号，由下单接口返回",
            "schema": {
              "type": "string"
            },
            "example": "N2026101500000000001"
          }
        ],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务失败（示例，msg 以实际返回为准）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "paymentType": {
                          "type": "string"
                        },
                        "paymentName": {
                          "type": "string"
                        },
                        "orderId": {
                          "type": "number"
                        },
                        "orderNo": {
                          "type": "string"
                        },
                        "amount": {
                          "type": "number"
                        },
                        "totalAmount": {
                          "type": "number"
                        },
                        "currency": {
                          "type": "string"
                        },
                        "productType": {
                          "type": "number"
                        },
                        "paidStatus": {
                          "type": "number"
                        },
                        "paid": {
                          "type": "boolean"
                        },
                        "status": {
                          "type": "number"
                        },
                        "payMessage": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "paymentType": "BALANCE",
                        "paymentName": "余额支付",
                        "orderId": 2001,
                        "orderNo": "N2026101500000000001",
                        "amount": 5,
                        "totalAmount": 5,
                        "currency": "USD",
                        "productType": 1,
                        "paidStatus": 20,
                        "paid": true,
                        "status": 1,
                        "payMessage": "success"
                      }
                    }
                  },
                  "example_3": {
                    "summary": "业务失败（示例，msg 以实际返回为准）",
                    "value": {
                      "code": 500,
                      "msg": "参数或业务校验失败，请检查输入"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_2": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/client/merchant/walletInfo": {
      "get": {
        "operationId": "get-client-merchant-walletInfo",
        "summary": "仪表盘余额信息",
        "tags": [
          "shared"
        ],
        "description": "",
        "security": [
          {
            "merchantCode": [],
            "merchantToken": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功返回（示例）；业务对象为空时（data 可省略）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "merchantId": {
                          "type": "number"
                        },
                        "balance": {
                          "type": "number"
                        },
                        "totalAmount": {
                          "type": "number"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "example_1": {
                    "summary": "成功返回（示例）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功",
                      "data": {
                        "merchantId": 1000,
                        "balance": 50,
                        "totalAmount": 5
                      }
                    }
                  },
                  "example_2": {
                    "summary": "业务对象为空时（data 可省略）",
                    "value": {
                      "code": 200,
                      "msg": "操作成功"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "鉴权失败（公共错误形状）",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "number"
                    },
                    "msg": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example_3": {
                    "summary": "鉴权失败（公共错误形状）",
                    "value": {
                      "code": 401,
                      "msg": "认证失败，请重新登录或检查商户密钥"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "merchantCode": {
        "type": "apiKey",
        "in": "header",
        "name": "x-merchant-code"
      },
      "merchantToken": {
        "type": "apiKey",
        "in": "header",
        "name": "x-merchant-token"
      },
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  }
}