云服务器内容精选

  • 背景信息 在配置VIP用户保障之前,需要开启VIP用户的优先接入、配置带宽预留、单独授权和AP设备位置空间,以保障VIP用户的体验。 VIP用户必须开启优先接入,否则VIP用户在SSID接入用户超过阈值后,无法接入SSID。 VIP用户必须开启带宽预留,缺省为20%。VIP用户带宽预留不够时,体验无法得到保障。 VIP用户必须配置单独授权结果,和普通用户做区分,否则AP无法识别VIP用户,会导致VIP用户无法得到体验保障。 VIP用户必须配置AP设备位置空间,否则无法查看用户旅程。
  • 响应示例 HTTP/1.1 200 OK Data:Tue,26 Jul 2022 17:31:54 GMT Server: example.com Content-Type: application/json { "resultData": [ { "startTime": 1598903602921, "endTime": 1598944449000, "offlineTime": 0, "costTime": 1598903602921, "accessAp": "area_2", "accessApMac": "1c-20-db-c9-**-**", "result": 0, "errorCode": null, "authOfflineErrorCode": null, "ssid": "Huawei-employee", "radioId": 0, "authId": null, "authType": null, "accessType": 1, "lastDhcpResult": -1 }, { "startTime": 1598903603461, "endTime": 1598944448450, "offlineTime": 0, "costTime": 1592503602921, "accessAp": "area_3", "accessApMac": "1c-20-db-c9-**-**", "result": 0, "errorCode": null, "authOfflineErrorCode": null, "ssid": "Huawei-employee", "radioId": 0, "authId": null, "authType": null, "accessType": 1, "lastDhcpResult": -1 } ], "resultCode": 200, "errorDes": "Success", "errorReson": "Successful.", "errorDetail": "Successful.", "errorAdvice": "Successful." }
  • 请求示例 POST /v1/ci/enaasclient/openapi/protocoltrace/sessionlist HTTP/1.1 Host: example.com Content-Type: application/json Accept: application/json POST /v1/ci/enaasclient/openapi/protocoltrace/sessionlist HTTP/1.1Content-Type: application/json;charset=UTF8Accept: application/jsonX-Auth-Token: MIIDwAYJKoZIhvcNAQcCoIIDsTCCA60CAQExDTALBglghkgBZQMEAgEwggIOBgkqhkiG9w0BBwGgggH--jxxA==body:{ "intervals":"[ "2020-08-27T16:00:00.000Z/2020-08-28T06:52:21.000Z" ]", "level":"0", "id":"/", "accType":"1", "usermac":"30-00-00-00-**-**" }
  • 请求Body参数 表2 请求Body参数列表 名称 类型 是否必选 描述 param String 是 查询条件,param为JSON格式字符串,包含以下参数: { "intervals":"[\"2020-08-27T16:00:00.000Z/2020-08-28T06:52:21.000Z\"]", // 查询时间范围,必填项。 "level":"0", // 左树级别。站点在左侧站点树的层级,对应0-9级,0为根,必填项。 "id":"/", // 站点区域ID,“/”为根区域,必填项。 "accType":"1", // 接入类型。包含1(无线)和0(有线),必填项。 "usermac":"30-00-00-00-**-**" // 用户的MAC地址,必填项。 }
  • 响应参数 返回状态码为 200: 获取会话列表成功。 表3 响应Body参数列表 名称 类型 是否必选 描述 resultCode Integer 否 状态码。 缺省值:200 errorDes String 否 错误描述。 缺省值:Successful. errorReson String 否 错误原因。 缺省值:Successful. errorDetail String 否 错误详情。 缺省值:Successful. errorAdvice String 否 错误建议。 缺省值:Successful. resultData Array of SessionModel 否 会话模型。 表4 SessionModel 名称 类型 是否必选 描述 startTime Long 否 会话开始时间。 缺省值:0 endTime Long 否 会话结束时间。 缺省值:0 offlineTime Long 否 离线时间。 缺省值:0 devStartTime Long 否 会话开始设备时间。 缺省值:0 devEndTime Long 否 会话结束设备时间。 缺省值:0 devOfflineTime Long 否 离线设备时间。 缺省值:0 costTime Long 否 查询时间。 缺省值:0 accessAp String 否 接入AP的名称。 accessApMac String 否 接入AP的MAC地址。 result Integer 否 接入结果。 缺省值:0 errorCode String 否 错误码。 authOfflineErrorCode String 否 离线错误码。 ssid String 否 SSID。 radioId Integer 否 射频ID。 authId String 否 会话ID。 authType String 否 认证类型。 accessType Integer 否 接入类型: - 0:有线 - 1:无线 缺省值:0 lastDhcpResult Integer 否 最后一次DHCP结果。 缺省值:-1 表5 返回状态码 返回状态码 状态码说明 响应参数 400 参数错误 无 401 该用户未认证 无 403 URL鉴权失败 无 404 REST接口没找到 无 500 服务器内部错误 无 502 网关错误 无 503 服务不可用 无
  • 响应示例 HTTP/1.1 200 OK Data:Tue,26 Jul 2022 17:31:54 GMT Server: example.com Content-Type: application/json { "data": { "UserTrend": [ { "timestamp": 1598903400000, "usernum": 46 }, { "timestamp": 1598904000000, "usernum": 7 }, { "timestamp": 1598904300000, "usernum": 6 }, { "timestamp": 1598904600000, "usernum": 6 }, { "timestamp": 1598904900000, "usernum": 4 }, { "timestamp": 1598905200000, "usernum": 15 } ] }, "resultCode": 0, "errorDes": "Successful.", "errorReson": "Success", "errorDetail": "Successful.", "errorAdvice": "Successful." }
  • URL /v1/ci/enaasclient/openapi/userstatistics/trend 表1 请求Query参数列表 名称 类型 是否必选 描述 param String 是 查询参数,queryparam格式: { "regionType": "site",//区域类型。包含site(站点)、region(区域)、building(楼宇)和floor(楼层),必填项。 "level": "0",//左树级别。站点在左侧站点树的层级,对应0-9级,0为根,必填项。 "showType": "radio",//查询类型,包含radio(射频)、accType(接入类型)和ssid(SSID),必填项。 "startTime": "1598544000000",//开始时间,必填项。 "id": "/",//站点区域ID,“/”为根区域,必填项。 "endTime": "1598601596000",//结束时间,必填项。 "isAutoRefresh": "false",//接口是否自动刷新,包含false(否)和true(是),必填项。 } 最小长度:1 表2 请求Header参数列表 名称 类型 是否必选 描述 X-Auth-Token String 是 认证Token,用于API的Token认证。 最小长度:0 最大长度:90000
  • 请求示例 GET /v1/ci/enaasclient/openapi/userstatistics/trend?param=null HTTP/1.1 Host: example.com Content-Type: application/json Accept: application/json GET /v1/ci/enaasclient/openapi/userstatistics/trend?param={ "regionType":"site", "level":"0", "showType":"radio", "startTime":"1598544000000", "id":"/", "endTime":"1598601596000", "isAutoRefresh":"false" } HTTP/1.1Content-Type: application/json;charset=UTF8Accept: application/jsonX-Auth-Token: MIIDwAYJKoZIhvcNAQcCoIIDsTCCA60CAQExDTALBglghkgBZQMEAgEwggIOBgkqhkiG9w0BBwGgggH--jxxA==
  • 响应参数 返回状态码为 200: 查询用户趋势成功。 表3 响应Body参数列表 名称 类型 是否必选 描述 resultCode Integer 否 状态码。 缺省值:200 errorDes String 否 错误描述。 缺省值:Successful. errorReson String 否 错误原因。 缺省值:Successful. errorDetail String 否 错误详情。 缺省值:Successful. errorAdvice String 否 错误建议。 缺省值:Successful. data Array of UserTrendModel 否 在线用户趋势数据模型。 表4 UserTrendModel 名称 类型 是否必选 描述 UserTrend Array of HotTimeModel 否 热点时段返回模型。 表5 HotTimeModel 名称 类型 是否必选 描述 timestamp Long 否 时间戳。 缺省值:0 usernum Long 否 用户数。 缺省值:0 表6 返回状态码 返回状态码 状态码说明 响应参数 400 参数错误 无 401 该用户未认证 无 403 URL鉴权失败 无 404 REST接口没找到 无 500 服务器内部错误 无 502 网关错误 无 503 服务不可用 无