有关 EnOS 数据订阅 API¶
EnOS 数据订阅是 EnOS Cloud 为提高用户获取和利用资产数据效率而推出的主动推送服务。通过该服务，应用无需不停轮询取数 API，即可获取资产时序数据、告警数据、资产事件数据等，显著提升 API 调用效率并降低其使用成本。
数据订阅服务提供了一系列由 EnOS 开放的 Open API 接口，帮助你获取订阅任务列表、任务详情以及更新订阅任务。关于 EnOS 数据订阅服务 API 的完整接口列表及功能说明，参见 API 列表。
API 列表
¶
你可以通过下表了解可以调用 API 执行哪些操作，每项操作对应的 URL，以及是否适用于 EnOS Cloud 和 EnOS Edge。
操作名称 |
描述 |
URL |
适用于 EnOS Cloud |
适用于 EnOS Edge |
|---|---|---|---|---|
获取订阅任务列表。 |
/subscription-service/v1/subscriptions |
√ |
× |
|
按任务 ID 获取订阅任务详情。 |
/subscription-service/v1/subscription/{subId} |
√ |
× |
|
更新订阅任务。 |
/subscription-service/v1/subscription |
√ |
× |
通用错误码¶
你可以通过下表了解数据订阅 API 的通用错误码。
代码 |
错误信息 |
描述 |
|---|---|---|
400001 |
Parameter illegal |
参数无效。 |
400002 |
Subscription ID, SA, organization or type fields are not allowed to be updated |
不支持修改订阅 ID，应用的 access key，OU ID，或订阅类型。 |
400003 |
Number of point in the subscription exceeds the limit |
当前订阅任务中的测点数量超过限制。 |
403001 |
Permission denied |
暂无权限。 |
404001 |
Subscription does not exist |
订阅任务不存在。 |
500001 |
System error |
系统异常。 |
相关链接¶
有关数据订阅的更多信息，参见 EnOS 数据订阅。
有关如何调用 EnOS API 的信息，参见 EnOS API 快速入门。