接口说明
面向政企版租户开放硬终端设备列表查询接口 业务逻辑：支持查询租户下的硬终端列表，支持分页，支持设备名称，设备型号，设备id，桌面名称，登录用户，绑定用户，模糊搜索支持锁定状态和连接状态搜索，列表信息包括：设备id、设备型号、设备名称、设备来源、设备类型、锁定状态、最近连接桌面名称、连接状态、登录用户、登录租户、绑定用户、所属租户、客户端（类型和版本号）、终端首次登录时间、终端最近一次登录时间。功能、限制、默认逻辑同企业管理门户 限流：根据租户实现用户级别的限流，限制为100次每秒
URL
POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/device/ccemp/getDeviceList
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
deviceReqDto
|
CcempDeviceReqDto
|
是
|
查询硬终端列表请求入参 |
|
connectStatus
|
string
|
否
|
连接状态 0 未连接；1 已连接 |
|
currentPage
|
integer(int32)
|
否
|
当前页 |
|
deviceCompany
|
string
|
否
|
设备厂商 |
|
deviceModel
|
string
|
否
|
设备型号 |
|
deviceName
|
string
|
否
|
设备名称 |
|
deviceOwner
|
string
|
否
|
所属用户 |
|
deviceSource
|
string
|
否
|
设备来源 1.定制终端-云能，2.定制终端-终端公司，3.通用终端 |
|
deviceTenant
|
string
|
否
|
所属租户 |
|
deviceType
|
string
|
否
|
设备类型 |
|
deviceUid
|
string
|
否
|
设备id |
|
lockState
|
integer(int32)
|
否
|
锁定状态 0 未锁定(默认)；1 已锁定 |
|
loginTenant
|
string
|
否
|
登录租户 |
|
machineName
|
string
|
否
|
桌面名称 |
|
pageSize
|
integer(int32)
|
否
|
每页显示条数 |
|
start
|
integer(int32)
|
否
|
当前页起始下标 |
|
tenantId
|
string
|
否
|
租户主键id |
|
userName
|
string
|
否
|
用户名 |
请求示例
POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/device/ccemp/getDeviceList{
"connectStatus":"0",
"tenantId":"2"
}返回参数
返回码：200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
PageReturnEntity«DeviceInfoRespDto»
|
请求成功时返回的数据 |
|
data
|
<DeviceInfoRespDto> array
|
数据 |
|
bindCount
|
integer(int32)
|
绑定用户数量 |
|
clientType
|
string
|
客户端类型 |
|
clientVersion
|
string
|
客户端版本 |
|
connectStatus
|
string
|
连接状态 0 未连接；1 已连接 |
|
cores
|
string
|
'核数 |
|
deviceCompany
|
string
|
设备厂商 |
|
deviceModel
|
string
|
设备型号 |
|
deviceName
|
string
|
设备名称 |
|
deviceOrderId
|
string
|
关联订单号 |
|
deviceSource
|
string
|
设备来源 1.定制终端-云能，2.定制终端-终端公司，3.通用终端 |
|
deviceTenant
|
string
|
所属租户 |
|
deviceTenantName
|
string
|
所属租户名称 |
|
deviceType
|
string
|
设备类型 |
|
deviceUid
|
string
|
设备ID(如macId，androidId，uuid等，不可重复) |
|
disk
|
string
|
硬盘大小 |
|
firstLoginTime
|
string
|
终端首次登录时间 |
|
id
|
string
|
设备表主键ID(唯一) |
|
ipAddress
|
string
|
IP地址 |
|
lockState
|
string
|
锁定状态 0 未锁定；1 已锁定 |
|
macAddress
|
string
|
MAC地址 |
|
operatingSystem
|
string
|
操作系统 |
|
operatingVersion
|
string
|
操作系统版本号 |
|
processor
|
string
|
'处理器' |
|
ram
|
string
|
内存大小 |
|
recentLoginMachine
|
string
|
最近连接桌面名称 |
|
recentLoginTenant
|
string
|
登录租户 |
|
recentLoginTenantName
|
string
|
登录租户名称 |
|
recentLoginTime
|
string
|
终端最近一次登录时间 |
|
recentLoginUser
|
string
|
登录用户 |
|
remark
|
string
|
备注 |
|
systemArchitecture
|
string
|
系统架构 |
|
totalCount
|
integer(int32)
|
总行数 |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
错误码提示信息 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,FORBIDDEN,REMAINING,TIMEOUT)
|
返回状态码;返回正常：OK,返回错误：ERROR,返回异常：EXCEPTION,需要告警实现的：ALARM,禁止访问：FORBIDDEN |
返回示例
返回码：200
OK
{
"state":"OK",
"body":{
"data":[
{
"id":"1761934592381218817",
"deviceUid":"219433886614",
"deviceName":"W600D SE-MB",
"deviceSource":"2",
"deviceType":"bijiben",
"deviceModel":"W600DSE-MB",
"deviceOrderId":null,
"lockState":"0",
"deviceTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"deviceTenantName":"csy_saas_test",
"connectStatus":"0",
"clientType":"aio_android64",
"clientVersion":"3.3.2",
"recentLoginUser":"lxjtest001",
"recentLoginTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"recentLoginTenantName":"csy_saas_test",
"recentLoginMachine":"我的电脑",
"firstLoginTime":"2024-02-26 10:01:56",
"recentLoginTime":"2024-09-25 20:55:48",
"ipAddress":"192.168.137.205",
"macAddress":"54:77:87:D4:96:20",
"deviceCompany":"ZX34190",
"processor":"1",
"cores":"1",
"ram":"1",
"disk":"1",
"systemArchitecture":"arm64-v8a",
"operatingSystem":"Android",
"operatingVersion":"Android 11",
"remark":null,
"mopUserId":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"bindCount":4
},
{
"id":"1734097873044217857",
"deviceUid":"SN830000D4400005",
"deviceName":"W600D SE-MB",
"deviceSource":"2",
"deviceType":"bijiben",
"deviceModel":"W600DSE-MB",
"deviceOrderId":null,
"lockState":"0",
"deviceTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"deviceTenantName":"csy_saas_test",
"connectStatus":"0",
"clientType":"aio_android64",
"clientVersion":"3.2.1",
"recentLoginUser":"android_wangyanqiang",
"recentLoginTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"recentLoginTenantName":"csy_saas_test",
"recentLoginMachine":"中心",
"firstLoginTime":"2023-12-11 14:28:45",
"recentLoginTime":"2024-09-25 20:27:11",
"ipAddress":"172.20.219.52,1.0.6.239",
"macAddress":"78:8A:86:10:A7:4A",
"deviceCompany":"ZX34190",
"processor":"1",
"cores":"1",
"ram":"1",
"disk":"1",
"systemArchitecture":"arm64-v8a",
"operatingSystem":"Android",
"operatingVersion":"Android 11",
"remark":null,
"mopUserId":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"bindCount":0
},
{
"id":"1826101895883374593",
"deviceUid":"219526364958",
"deviceName":"eCloudBook Pro 24RTW",
"deviceSource":"2",
"deviceType":"bijiben",
"deviceModel":"eCloudBookPro24RTW",
"deviceOrderId":null,
"lockState":"0",
"deviceTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"deviceTenantName":"csy_saas_test",
"connectStatus":"1",
"clientType":"sy_aio_android",
"clientVersion":"3.3.5",
"recentLoginUser":"android_wangyanqiang",
"recentLoginTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"recentLoginTenantName":"csy_saas_test",
"recentLoginMachine":"我的电脑-cmss-A001",
"firstLoginTime":"2024-08-21 11:39:53",
"recentLoginTime":"2024-09-25 17:58:07",
"ipAddress":"172.20.219.18,1.0.7.178",
"macAddress":"C0:4B:24:29:F9:B4",
"deviceCompany":"SY00001",
"processor":"RK3568",
"cores":"4",
"ram":"4",
"disk":"32",
"systemArchitecture":"arm64-v8a",
"operatingSystem":"Android",
"operatingVersion":"Android 11",
"remark":null,
"mopUserId":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"bindCount":4
},
{
"id":"1825368136552792066",
"deviceUid":"219458344759",
"deviceName":"eCloudBook Pro 24RTW",
"deviceSource":"2",
"deviceType":"bijiben",
"deviceModel":"eCloudBookPro24RTW",
"deviceOrderId":null,
"lockState":"0",
"deviceTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"deviceTenantName":"csy_saas_test",
"connectStatus":"0",
"clientType":"sy_aio_android",
"clientVersion":"3.3.1",
"recentLoginUser":"hj88.dddddd",
"recentLoginTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"recentLoginTenantName":"csy_saas_test",
"recentLoginMachine":"h-win",
"firstLoginTime":"2024-08-19 11:04:12",
"recentLoginTime":"2024-09-25 17:42:51",
"ipAddress":"172.20.219.254,1.0.2.219",
"macAddress":"40:9C:A7:5A:E7:A4",
"deviceCompany":"SY00001",
"processor":"RK3568",
"cores":"4",
"ram":"4",
"disk":"32",
"systemArchitecture":"arm64-v8a",
"operatingSystem":"Android",
"operatingVersion":"Android 11",
"remark":null,
"mopUserId":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"bindCount":1
},
{
"id":"1838470161807503361",
"deviceUid":"219551321754",
"deviceName":"eCloudBook Pro 24RTW",
"deviceSource":"2",
"deviceType":"bijiben",
"deviceModel":"eCloudBookPro24RTW",
"deviceOrderId":null,
"lockState":"0",
"deviceTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"deviceTenantName":"csy_saas_test",
"connectStatus":"0",
"clientType":null,
"clientVersion":null,
"recentLoginUser":"wxcsy070501",
"recentLoginTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"recentLoginTenantName":"csy_saas_test",
"recentLoginMachine":null,
"firstLoginTime":"2024-09-24 14:46:58",
"recentLoginTime":"2024-09-25 17:02:41",
"ipAddress":"192.168.137.102",
"macAddress":"A8:4F:A4:2D:E0:64",
"deviceCompany":"SY00001",
"processor":"RK3568",
"cores":"4",
"ram":"4",
"disk":"32",
"systemArchitecture":"arm64-v8a",
"operatingSystem":"Android",
"operatingVersion":"Android 11",
"remark":null,
"mopUserId":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"bindCount":0
},
{
"id":"1725426914431049729",
"deviceUid":"219433886626",
"deviceName":"W600D SE-MB",
"deviceSource":"2",
"deviceType":"bijiben",
"deviceModel":"W600DSE-MB",
"deviceOrderId":null,
"lockState":"0",
"deviceTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"deviceTenantName":"csy_saas_test",
"connectStatus":"0",
"clientType":"aio_android64",
"clientVersion":"3.2.1",
"recentLoginUser":"cmss_zhangzhixiang",
"recentLoginTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"recentLoginTenantName":"csy_saas_test",
"recentLoginMachine":"我的电脑",
"firstLoginTime":"2023-11-17 16:13:27",
"recentLoginTime":"2024-09-25 16:34:47",
"ipAddress":"192.168.137.83",
"macAddress":"78:8A:86:25:AE:06",
"deviceCompany":"ZX34190",
"processor":"1",
"cores":"1",
"ram":"1",
"disk":"1",
"systemArchitecture":"arm64-v8a",
"operatingSystem":"Android",
"operatingVersion":"Android 11",
"remark":null,
"mopUserId":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"bindCount":0
},
{
"id":"1742111984677203970",
"deviceUid":"SN830000D4400257",
"deviceName":"W600D SE-MB",
"deviceSource":"2",
"deviceType":"bijiben",
"deviceModel":"W600DSE-MB",
"deviceOrderId":"123123",
"lockState":"0",
"deviceTenant":"CIDC-U-403ced6d255c4e9dbde36ecdab4f6ee6",
"deviceTenantName":"csy_csb_saas_libaodong_095",
"connectStatus":"0",
"clientType":"aio_android64",
"clientVersion":"3.3.2",
"recentLoginUser":"wxcsy_0705",
"recentLoginTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"recentLoginTenantName":"csy_saas_test",
"recentLoginMachine":"升级8C8G",
"firstLoginTime":"2024-01-02 17:13:58",
"recentLoginTime":"2024-09-25 15:16:35",
"ipAddress":"192.168.137.139",
"macAddress":"78:8A:86:10:AA:52",
"deviceCompany":"ZX34190",
"processor":"1",
"cores":"1",
"ram":"1",
"disk":"1",
"systemArchitecture":"arm64-v8a",
"operatingSystem":"Android",
"operatingVersion":"Android 11",
"remark":null,
"mopUserId":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"bindCount":1
},
{
"id":"1838830738334068738",
"deviceUid":"219551322141",
"deviceName":"eCloudBook Pro 24RTW",
"deviceSource":"2",
"deviceType":"bijiben",
"deviceModel":"eCloudBookPro24RTW",
"deviceOrderId":null,
"lockState":"0",
"deviceTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"deviceTenantName":"csy_saas_test",
"connectStatus":"0",
"clientType":null,
"clientVersion":null,
"recentLoginUser":"wxcsy_0705",
"recentLoginTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"recentLoginTenantName":"csy_saas_test",
"recentLoginMachine":null,
"firstLoginTime":"2024-09-25 14:39:46",
"recentLoginTime":"2024-09-25 14:44:09",
"ipAddress":"192.168.137.219",
"macAddress":"A8:4F:A4:2D:A5:4C",
"deviceCompany":"SY00001",
"processor":"RK3568",
"cores":"4",
"ram":"4",
"disk":"32",
"systemArchitecture":"arm64-v8a",
"operatingSystem":"Android",
"operatingVersion":"Android 11",
"remark":null,
"mopUserId":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"bindCount":0
},
{
"id":"1833792258628038657",
"deviceUid":"SN830000D3E00095",
"deviceName":"W600D SE-MB",
"deviceSource":"2",
"deviceType":"bijiben",
"deviceModel":"W600DSE-MB",
"deviceOrderId":null,
"lockState":"0",
"deviceTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"deviceTenantName":"csy_saas_test",
"connectStatus":"0",
"clientType":"aio_android64",
"clientVersion":"3.3.2",
"recentLoginUser":"wxcsy070504",
"recentLoginTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"recentLoginTenantName":"csy_saas_test",
"recentLoginMachine":null,
"firstLoginTime":"2024-09-11 16:58:39",
"recentLoginTime":"2024-09-25 14:29:22",
"ipAddress":"192.168.137.160",
"macAddress":"E0:75:26:99:F5:E0",
"deviceCompany":"ZX34190",
"processor":"1",
"cores":"1",
"ram":"1",
"disk":"1",
"systemArchitecture":"arm64-v8a",
"operatingSystem":"Android",
"operatingVersion":"Android 11",
"remark":null,
"mopUserId":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"bindCount":2
},
{
"id":"1833755981451014145",
"deviceUid":"SN760000C9T00941",
"deviceName":"Android Bluedroid",
"deviceSource":"2",
"deviceType":"aio",
"deviceModel":"W600D",
"deviceOrderId":null,
"lockState":"0",
"deviceTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"deviceTenantName":"csy_saas_test",
"connectStatus":"0",
"clientType":"aio_android64",
"clientVersion":"3.3.2",
"recentLoginUser":"wxcsy_0705",
"recentLoginTenant":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"recentLoginTenantName":"csy_saas_test",
"recentLoginMachine":null,
"firstLoginTime":"2024-09-11 14:34:30",
"recentLoginTime":"2024-09-25 10:33:27",
"ipAddress":"192.168.137.60",
"macAddress":"E0:51:D8:07:91:75",
"deviceCompany":"ZX34190",
"processor":"2",
"cores":"2",
"ram":"4",
"disk":"4",
"systemArchitecture":"arm64-v8a",
"operatingSystem":"Android",
"operatingVersion":"Android 11",
"remark":null,
"mopUserId":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
"bindCount":15
}
],
"totalCount":182
},
"errorCode":"200",
"errorMessage":"",
"requestId":"a11ba2f0d31b4d1f8a010cf904d48a19"
}