调用频率限制

更新时间: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