API 变更


该部分介绍在 EnOS 3.0.0 中的 API 行为变更。

API 鉴权


模型服务、接入服务、资产服务 和 资产树服务 API 默认启用细粒度的鉴权模式。在调用这些 API 前，需前往 应用门户 > 开发者控制台 > 应用 > API 管理 > API 授权，为该 API 添加需要授权的应用，应用才能调用 API。更多信息，参见 API 鉴权。

模型/资产/设备 API


以下变更适用于 模型服务、资产服务 以及接入服务中的 设备 API。


变更描述

适用于 EnOS Cloud

适用于 EnOS Edge

对于使用了国际化结构的请求参数，若指定该参数，则国际化结构中的 defaultValue 字段必填。

√

√

对于通过 assetId 或 productKey+deviceKey 指定资产的 API，如果请求内容格式错误，将无法请求成功，提示参数错误。

√

√

模型服务


API

变更描述

适用于 EnOS Cloud

适用于 EnOS Edge

Search Thing Model

  • 支持在请求参数 expression 中使用 like 运算符查询 modelId 和 modelName 字段。

  • 支持同时使用 expression 和 relationFilter 进行搜索。

√

√

连接服务


API

变更描述

适用于 EnOS Cloud

适用于 EnOS Edge

当请求参数 productKey 为空时，将无法请求成功，返回参数错误。

√

×

Batch Create Devices

支持为请求参数 productKey 填入多个值，为多个产品同时创建设备。

√

×

Remove Sub-Device

当请求参数 subDevices 为空时，仍可请求成功，但不移除任何子设备。

√

×

资产树服务


API

变更描述

适用于 EnOS Cloud

适用于 EnOS Edge

Search Asset Tree

如未指定请求参数 pagination，默认每页 10 条数据。

√

×