调用频率限制

更新时间：2024-06-05 03:26:28下载pdf

为保障系统稳定性，以及为您提供最佳性能和优质的开发体验，涂鸦为不同的云服务 OpenAPI 设定了相应的调用频率。本文介绍了云服务 OpenAPI 具体的频率限制。如果您需要更多帮助，请提交工单联系涂鸦技术支持。

本文涉及的 API 限制，以单个云项目为准。例如，POST:/v2.0/cloud/space/creation 的限制为不大于 10 次每秒，说明单个云项目内，您在一秒内调用该接口的最高次数为 10 次，超出则会受到限制。云项目相关操作，请参考管理项目。

空间

API	说明	限制（次/秒）
POST:/v2.0/cloud/space/creation	创建空间	10
DELETE:/v2.0/cloud/space/{space_id}	删除空间	10
GET:/v2.0/cloud/space/{space_id}	查询空间	20
GET:/v2.0/cloud/space/child	查询空间子节点列表	20
GET:/v2.0/cloud/space/{space_id}/resource	查询空间下资源列表	20
PUT:/v2.0/cloud/space/{space_id}	修改空间信息	10
GET:/v2.0/cloud/space/relation	判断父子节点关系	20

API	说明	限制（次/秒）
GET:/v2.0/cloud/thing/{device_id}/model	查询物模型	10
POST:/v2.0/cloud/thing/{device_id}/shadow/actions	下发动作	4
POST:/v2.0/cloud/thing/{device_id}/shadow/properties/issue	下发属性	4
GET:/v2.0/cloud/thing/{device_id}/shadow/properties	查询属性	50
POST:/v2.0/cloud/thing/{device_id}/shadow/properties/desired	设置期望属性	4
GET:/v2.0/cloud/thing/{device_id}/shadow/properties/desired	查询期望属性	10
POST:/v2.0/cloud/thing/{device_id}/shadow/properties	修改属性	4

API	说明	限制（次/秒）
POST:/v2.0/cloud/thing/group	创建群组	2
DELETE:/v2.0/cloud/thing/group/{group_id}	删除群组	2
GET:/v2.0/cloud/thing/group/{group_id}	查询群组	4
PUT:/v2.0/cloud/thing/group/{group_id}/{name}	修改群组名称	4
GET:/v2.0/cloud/thing/group	获取空间下群组	4
PUT:/v2.0/cloud/thing/group/{group_id}/devices	添加设备	4
DELETE:/v2.0/cloud/thing/group/{group_id}/devices	删除设备	2
GET:/v2.0/cloud/thing/group/device/{device_id}	获取设备所在群组	4
GET:/v2.0/cloud/thing/group/{group_id}/properties	查询群组属性	4
POST:/v2.0/cloud/thing/group/properties	下发群组属性	4
GET:/v2.0/cloud/thing/group/{group_id}/devices	查询群组设备	4

API	说明	限制（次/秒）
GET:/v2.0/cloud/thing/{device_id}	查询单个设备详情	10
GET:/v2.0/cloud/thing/batch	批量查询设备详情	4
GET:/v2.0/cloud/thing/{device_id}/state	获取设备状态	5
GET:/v2.0/cloud/thing/{device_id}/logs	获取设备操作日志	5
GET:/v2.0/cloud/thing/{device_id}/report-logs	获取设备状态上报日志	10
POST:/v2.0/cloud/thing/{device_id}/attribute	修改设备基础属性	10
POST:/v2.0/cloud/thing/{device_id}/transfer	转移设备	5
DELETE:/v2.0/cloud/thing/{device_id}	移除设备	10
POST:/v2.0/cloud/thing/{device_id}/freeze	冻结 / 解冻设备	5
GET:/v2.0/cloud/thing/{device_id}/firmware	获取设备升级信息	5
GET:/v2.0/cloud/thing/{device_id}/firmware/{channel}/progress	获取设备升级进度	10
POST:/v2.0/cloud/thing/{device_id}/firmware/{channel}	确认开始设备升级	5
POST:/v2.0/cloud/thing/{device_id}/reset	恢复出厂设置	10

API	说明	限制（次/秒）
POST:/v2.0/cloud/scene/rule	新增联动规则	5
DELETE:/v2.0/cloud/scene/rule	删除联动规则	10
GET:/v2.0/cloud/scene/rule	查询联动规则列表	30
GET:/v2.0/cloud/scene/rule/{rule_id}	获取联动规则详情	20
PUT:/v2.0/cloud/scene/rule/{rule_id}	修改联动规则	5
POST:/v2.0/cloud/scene/rule/{rule_id}/actions/trigger	触发场景	10
PUT:/v2.0/cloud/scene/rule/state	启用或禁用联动规则	5

API	说明	限制（次/秒）
PUT:/v2.0/cloud/timer/device/{device_id}/state	启用或禁用设备定时	30
GET:/v2.0/cloud/timer/device/{device_id}	查询设备定时	50
POST:/v2.0/cloud/timer/device/{device_id}	新增设备定时	20
PUT:/v2.0/cloud/timer/device/{device_id}	修改设备定时	30
DELETE:/v2.0/cloud/timer/device/{device_id}/batch	批量删除设备定时	10
DELETE:/v2.0/cloud/timer/device/{device_id}	清空设备定时	10