-
响应示例 返回状态码为200：查询成功。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "",
"pageIndex" : "1",
"pageSize" : "20",
"totalRecords" : "50",
"data" : [
{
"id" : "d5f17ddd0b25471bb0109d32cbc3a724",
"siteId" : "351e1696-02a2-4a68-bad4-aa639359c222",
"userName" : "1",
"lastChargeTime" : "1545812248932",
"usedFlow" : "100",
"usedTime" : "20",
"policyFlow" : "111111",
"policyTime" : "2222",
"remianFlow" : "111011",
"remianTime" : "2202",
"loginIp" : "10.1.1.1",
"terminalMac" : "22-22-22-22-22-22",
"oneOnlinePolicyTime" : "2211",
"oneOnlineUsedTime" : "11",
"oneOnlineRemainTime" : "2200"
}
]
} 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
响应参数 返回状态码为200：查询成功。 表4 TimeFlowStInfosResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" pageIndex int32 [0-2000000] - 当前页数。 "1" pageSize int32 [0-1000] - 每页最大显示数量。 "20" totalRecords int32 [0-2147483647] - 查询到的总结果数。 "50" data ARRAY_REFERENCE 0-1000个列表项，详细请参见表5。 查询到的结果列表。 - 表5 TimeFlowStDetailInfosResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - 流量时长ID，uuid格式。 "d5f17ddd0b25471bb0109d32cbc3a724" siteId string - - 站点ID，uuid格式。 "351e1696-02a2-4a68-bad4-aa639359c222" userName string 1~128个字符。 - 用户名。 "1" lastChargeTime string - - 最后一次计费更新时间，单位：毫秒。 "1545812248932" usedFlow string - - 已使用流量，单位：兆。 "100" usedTime string - - 已使用时间，单位：分钟。 "20" policyFlow string - - 策略流量单位：兆。 "111111" policyTime string - - 策略时长，单位：分钟。 "2222" remianFlow string - - 剩余流量，单位：兆。 "111011" remianTime string - - 剩余时长，单位：分钟。 "2202" loginIp string - - 终端IP。 "10.1.1.1" terminalMac string - - 终端MAC，mac格式：XX-XX-XX-XX-XX-XX。 "22-22-22-22-22-22" oneOnlinePolicyTime string - - 单次在线策略时长，单位：分钟。 "2211" oneOnlineUsedTime string - - 单次在线已使用时长，单位：分钟。 "11" oneOnlineRemainTime string - - 剩余单次时长，单位：分钟。 "2200" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。
-
请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表3。 查询流量时长请求信息。 - 表3 TimeFlowStInfoInputDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 pageIndex 是 string [0-2000000] 1 当前页数，默认为1。 "1" pageSize 是 string [0-1000] 20 每页显示的最大数量，默认为20。 "20" sort 否 string - userName 排序字段，目前只支持用户名排序。userName为正序，-userName为逆序。 "userName" userName 否 string 1~128个字符。 - 用户名，支持模糊匹配。 "zhangsan" usedTime 否 string - - 已使用时长，会查询大于等于已使用时长，单位：分钟。 "2222" usedFlow 否 string - - 已使用流量，会查询大于等于已使用流量，单位：兆。 "111111" beginTime 否 string - - 最后一次计费时间起始时间，单位：毫秒。 "1511515615000" endTime 否 string - - 最后一次计费时间截止时间，单位：毫秒。 "1511602015000" timeFlowStType 是 string user terminal - 流量时长类型，用户级(user)和终端级(terminal)。 "user"
-
请求示例 HTTP的示例 POST /controller/campus/v1/accountservice/user/timeflowstinfos/sites/fbb684c8-0d37-496f-bafa-4b06d5151e2e/timeflowst HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-AC
CES S-TOKEN: x-yyyyyy
{
"pageIndex" : "1",
"pageSize" : "20",
"sort" : "userName",
"userName" : "zhangsan",
"usedTime" : "2222",
"usedFlow" : "111111",
"beginTime" : "1511515615000",
"endTime" : "1511602015000",
"timeFlowStType" : "user"
}
-
URI /controller/campus/v1/accountservice/user/timeflowstinfos/sites/{siteId}/timeflowst 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 string - - 站点ID，UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"
-
响应示例 返回状态码为200：查询成功。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"pageIndex" : "1",
"pageSize" : "20",
"totalRecords" : "50",
"errcode" : "0",
"errmsg" : "",
"data" : [
{
"id" : "75f8ed0f-810a-4ff5-8e64-67c81312d01c",
"siteId" : "351e1696-02a2-4a68-bad4-aa639359c222",
"userName" : "1",
"lastChargeTime" : "1545812248932",
"usedFlow" : "20",
"usedTime" : "20",
"policyFlow" : "50",
"policyTime" : "50",
"remainFlow" : "30",
"remainTime" : "30"
}
]
} 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
请求示例 HTTP的示例 GET /controller/campus/v1/accountservice/user/timeflowstinfos?siteId=a91e1696-02a2-4a68-bad4-aa639359c8cf&pageIndex=1&pageSize=20&sort=userName&userName=zhangsan&usedTime=20&usedFlow=10&beginTime=2017-11-24 17:26:55&endTime=2017-11-25 17:26:55 HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
-
响应参数 返回状态码为200：查询成功。 表2 TimeFlowStInfosOutputDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 pageIndex int32 [0-2147483647] - 当前页数。 "1" pageSize int32 [0-1000] - 每页最大显示数量。 "20" totalRecords int32 [0-2147483647] - 查询到的总结果数。 "50" errcode string - - 错误码。 "0" errmsg string - - 错误信息描述。 "" data ARRAY_REFERENCE 0-1000个列表项，详细请参见表3。 查询到的用户流量结果列表。 - 表3 TimeFlowStDetailInfosOutputDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - 流量时长ID。 "75f8ed0f-810a-4ff5-8e64-67c81312d01c" siteId string - - 站点ID。 "351e1696-02a2-4a68-bad4-aa639359c222" userName string - - 账号名。 "1" lastChargeTime string - - 最后一次计费更新时间。 "1545812248932" usedFlow string - - 已使用流量（兆）。 "20" usedTime string - - 已使用时间（分钟）。 "20" policyFlow string - - 策略流量（兆）。 "50" policyTime string - - 策略时长（分钟）。 "50" remainFlow string - - 剩余流量。 "30" remainTime string - - 剩余时长。 "30" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。
-
URI /controller/campus/v1/accountservice/user/timeflowstinfos 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 否 string - - 站点ID，UUID格式。若不填，则查询未加入站点场景下的流量时长。 "a91e1696-02a2-4a68-bad4-aa639359c8cf" pageIndex 否 int32 [0-2000000] - 当前页数，默认为1。 1 pageSize 否 int32 [0-1000] - 每页显示的最大数量，默认为20。 20 sort 否 string - - 排序字段，目前只支持用户名排序。userName为正序，-userName为逆序。 "userName" userName 否 string 0~128个字符。 - 用户名，最大长度为128。 "zhangsan" usedTime 否 string - - 已使用时长(分钟)大于等于当前条件值。 "20" usedFlow 否 string - - 已使用流量(兆)大于等于当前条件值。 "10" beginTime 否 string - - 最后一次计费时间起始时间。 "2017-11-24 17:26:55" endTime 否 string - - 最后一次计费时间截止时间。 "2017-11-25 17:26:55"
