涂鸦开发者平台开放多种业务 API 服务全面覆盖全屋智能管理行业通用设备用户管理垂直品类开放能力各类数据服务等业务需求本文为您介绍如何开通 API 服务并授予项目 API 服务的调用权限 您调用的部分 云服务 API 会获取用户个人隐私数据因此您有义务根据所在地区的法律制定必要的用户隐私政策并采取足够的措施以确保 用户个人隐私数据充分受到保护 开通云服务 API 开通云服务 API 后如果您需要查看 API 的详细介绍请参考 云服务 API 参考

业务架构 涂鸦提供了通用的云端服务与智能设备建立了安全的双向通信连接然后基于此在全链路开放了云服务 API 和消息主题Topic让您可以将智能设备集成到自身业务应用中 在上图所示的 API 服务中涂鸦云端对外开放的能力主要分成了以下几个部分： IoT Core：包含了 IoT 业务的核心功能提供了涂鸦最基础的设备全生命周期管理能力适用于任何行业与 IoT 结合的场景基于 IoT Core您可以管理任何涂鸦生态内的设备和数据

云服务 API 于 2023 年 6 月 20 日进行了目录结构调整本文介绍调整详情更多详情请访问 涂鸦开发者平台 对于历史客户涂鸦会根据 API 调整同步前后的的订阅关系不会影响到客户的调用权限 IoT Core 调整说明 IoT Core 下仅保留了 设备 和 空间 相关的 API这些 API 是在涂鸦体系里完全通用的开放能力 新增六个 API 分组 迁移原 行业设备体系 到 行业基础服务包

如需了解涂鸦开放的所有 API请参考 云服务 API IoT Core 连接服务 提供涂鸦最核心的设备连接和管理能力便于您管理接入涂鸦生态的海量设备基于设备数据上报和云端下发指令控制帮助您基于涂鸦设备生态快速构建物联网场景应用本服务包含了设备管理设备控制资产管理和用户管理等基础 API更多详情请查看 IoT Core 服务

如需了解涂鸦开放的所有 API请参考 云服务 API IoT Core 连接服务 提供涂鸦最核心的设备连接和管理能力便于您管理接入涂鸦生态的海量设备基于设备数据上报和云端下发指令控制帮助您基于涂鸦设备生态快速构建物联网场景应用本服务包含了设备管理设备控制资产管理和用户管理等基础 API更多详情请查看 IoT Core 服务 其他服务 行业通用业务能力 服务名称 介绍 行业通用组织管理 提供组织架构管理相关的 API可根据行业场景构建人员组织架构

平台于 2023 年 6 月 20 日对 API 目录结构进行了调整若您需要查看历史文档请访问 请注意已归档的 API 文档不再更新推荐您使用或者迁移到推荐替代的 API详情请参考 云服务 API 调整说明若有疑问您可以 提交工单 或者联系您的涂鸦客户经理

由于策略调整涂鸦 将放缓迭代速度且部分 API 有计划停止迭代 如果您有新的云项目开始开发涂鸦建议您优先评估 是否可以完全满足您的业务需求如果不能涂鸦推荐您优先使用云服务 IoT Core通过 IoT Core 提供的基础能力 API 来实现您的项目 智慧校园 基于涂鸦的智能硬件生态和开发者平台能力围绕 校园教室宿舍 等核心场景提供全品类硬件和行业场景能力支持助力开发者打造数字校园安全校园智慧校园完整解决方案

API 产品 描述 设备 OTA 固件升级 通过 API 查询设备可升级的固件列表并指定对应的固件版本进行升级 某些设备会有不可跳过的中间版本固件需要先升级中间版本再升级到更新的版本 实时音视频 通过 API 获取智能设备的实时视频流要求设备固件需基于涂鸦 IPC SDK 4.7.0 以上版本进行开发 RTSP 和 HLS 只根据转发产生的流量计费WebRTC 在 P2P 状态下只按 P2P 连接时长计费在流量转发状态下只按转发产生的流量计费

涂鸦开发者平台支持通过 API 调试 功能对 API 进行调用验证 API 调试时涂鸦将使用当前项目的授权密钥Access ID & Access Secret获取临时 Token对线上资源发起调用请知晓 前提条件 已开通相关 API 权限开通方法参考 管理 API 服务 操作步骤 登录 涂鸦开发者平台 选择 云开发 > API 调试 在 API 调试 页面调用 API 选择项目 选择需要调用的 API 产品

开发者可根据需求按照具体的 API 对接文档规则调用 API实现应用 本章节为您介绍使用涂鸦 API 过程中所涉及的请求结构授权方式签名机制等技术要点便于您快速实现 API 调用 文档列表 请求结构 授权方式 签名机制 API 列表 相关文档 开通云服务：调用 API 前请确保您已开通相关的云服务 调试 API：涂鸦开发者平台提供 API 调试工具辅助您的业务开发和调试同时您也可以使用主流的调试工具进行调试