EMU设备信息

查看、更新设备信息。

根据更新时间范围获取设备列表

• Method：GET

• URL：https://www.einfra.cn/wad/ems/v1/api/device/by-time

• 接口描述：根据更新时间获取设备列表

• 请求

  • Query参数

    参数	类型	是否必填	描述	范围	样例
    start_time	int		开始时间戳（单位：秒）	[0, ∞]	1696089600
    end_time	int		结束时间戳（单位：秒）	[0, ∞]	1697179204
    page-size	int		每页设备数量（默认值为50）	[0, ∞]	50
    page	int		页码（默认值 1）	[0, ∞]	1

  • 示例

cURL

Python

Untitled

• 响应

  • 数据类型：application/json

    参数	类型	是否必填	描述	范围	样例
    code	int		错误码	见下文错误码	0
    message	str		错误描述	-	-
    data	listResult		每页设备数量（默认值为50）	-	50

  • listResult

    参数	类型	是否必填	描述	范围	样例
    total	int		总设备数	[0, ∞]	10
    list	[]emsDevice		设备列表	-	-

  • emsDevice

    参数	类型	是否必填	描述	范围	样例
    uid	str		设备唯一ID	-	xxxxx
    license_code	str		激活码	-	DNAFPQFRTWXXUKRJ
    name	str		设备名	-	EMS设备
    code	int		代码		1
    location	str		所在位置		上海
    affiliation	int		拥有权限	1-管理 2-查看	1
    heartbeat_time	time		最后心跳时间	-	2023-10-01T00:00:00Z

• 错误码

  HTTP状态码	错误码	描述
  400	100001	参数格式错误

获取设备列表

• Method：GET

• URL：https://www.einfra.cn/wad/ems/v1/api/device

• 接口描述：获取设备列表

• 请求

  • Query参数

    参数	类型	是否必填	描述	范围	样例
    page-size	int		每页设备数量（默认值为50）	[0, ∞]	50
    page	int		页码（默认值 1）	[0, ∞]	1

  • 示例

cURL

curl --location 'https://www.einfra.cn/wad/ems/v1/api/device?page-size=10&page=1' \
--header 'X-API-Key: YH3kPJ5rKV'

Python

import requests

url = "https://www.einfra.cn/wad/ems/v1/api/device?page-size=10&page=1"

headers = {
  'X-API-Key': 'YH3kPJ5rKV'
}

response = requests.request("GET", url, headers=headers)

print(response.text)

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://www.einfra.cn/wad/ems/v1/api/device?page-size=10&page=1")
  .method("GET", body)
  .addHeader("X-API-Key", "YH3kPJ5rKVP")
  .build();
Response response = client.newCall(request).execute();java

• 响应

  • 数据类型：application/json

  • 同/device/by-time

• 错误码

  HTTP状态码	错误码	描述
  400	100001	参数格式错误

更新设备信息

• Method：PATCH

• URL：https://www.einfra.cn/wad/ems/v1/api/device

• 接口描述：更新设备信息

• 请求

  • Body参数

    参数	类型	是否必填	描述	范围	样例
    uid	str		设备唯一ID	-	xxxxx
    name	str		设备名称（唯一）	长度小于48，无空格	ems设备
    code	int		设备代码	[0, ∞]	10312
    location	str		设备位置	长度小于256	上海

• 响应

  • 数据类型：application/json

    参数	类型	是否必填	描述	范围	样例
    code	int		错误码	见下文错误码	0
    message	str		描述	-	设备修改成功

• 错误码

  HTTP状态码	错误码	描述
  400	100001	参数格式错误
  400	100007	该记录未找到
  400	100010	名称重复