Changed APIs¶

EnOS 3.0.0 introduces the following API behavioral changes.

API Authentication¶

EnOS 3.0.0 enabled fine-grained authorization mode for Model Service, Connection Service, Asset Service, and Asset Tree Service APIs by default. Before calling these APIs, you need to go to Application Portal > Developer Console > API Management > API Authorization and add the application that needs to be authorized for the API, so that the application can call the API. For more information, see API Authentication.

Model/Asset/Device APIs¶

The following changes apply to Model Service, Asset Service, and the Device APIs within Connection Service.

Description	EnOS Cloud	EnOS Edge
If a request parameter with the internationalization structure is specified, the `defaultValue` field in the internationalization structure is required.	√	√
For APIs that require specifying assets through `assetId` or `productKey+deviceKey`, if the request format is incorrect, the request will fail and an error message will be prompted.	√	√

Model Service¶

API Name	Description	EnOS Cloud	EnOS Edge
Search Thing Model	Supports the use of the `like` operator in the request parameter `expression` for querying the `modelId` and `modelName` fields. Supports searching using both `expression` and `relationFilter` simultaneously.	√	√

Connection Service¶

API Name	Description	EnOS Cloud	EnOS Edge
Create Device Batch Create Devices	When the request parameter `productKey` is empty, the request will fail and return a parameter error.	√	×
Batch Create Devices	Supports providing multiple values for the request parameter `productKey` to create devices for multiple products simultaneously.	√	×
Remove Sub-Device	When the request parameter `subDevices` is empty, the request will still succeed, but no sub-devices will be removed.	√	×

Asset Tree Service¶

API Name	Description	EnOS Cloud	EnOS Edge
Search Asset Tree	If the request parameter `pagination` is not specified, the default is 10 records per page.	√	×
Search Asset Path	The response parameter `totalSize` will return the number of first-level child nodes, excluding the number of subordinate nodes under those child nodes.	√	×