云服务 API 参考云服务 API 概述

云服务 API 概述

更新时间:2023-07-19 02:45:57下载pdf

欢迎您选择涂鸦云开发。云开发是涂鸦推出的云端 IoT 能力开放中心,汇聚了超过 1000 个 OpenAPI,涵盖 IoT 应用开发所需的设备生命周期管理、数据分析和垂直行业场景开放能力。

业务架构

涂鸦提供了通用的云端服务与智能设备建立了安全的双向通信连接,然后基于此在全链路开放了云服务 API 和消息主题(Topic),让您可以将智能设备集成到自身业务应用中。

云服务 API 概述

在上图所示的 API 服务中,涂鸦云端对外开放的能力主要分成了以下几个部分:

  • IoT Core:包含了 IoT 业务的核心功能,提供了涂鸦最基础的设备全生命周期管理能力,适用于任何行业与 IoT 结合的场景。基于 IoT Core,您可以管理任何涂鸦生态内的设备和数据。
  • 设备高级服务:提供智能设备的进阶能力,例如设备定时、设备定位、视频云存储等,并针对部分分类设备提供了高级能力。
  • 全屋智能场景:是在涂鸦智能 C 端应用(以 OEM App 为主)基础之上进行的能力开放,让您可以更方便地管理您的用户、设备数据。并开放了全屋场景特色的服务,如数据分析、用户反馈管理等,让您可以快速进行二次开发,提升用户体验和运营效率。
  • 行业场景:涂鸦基于行业资产体系,构建了部分行业场景的 PaaS 能力开放。如果您刚好是这些场景的,欢迎查看这些能力验证是否符合您的业务需求。

    涂鸦推出了更加具有普适性的空间模型,能够替换资产模型。推荐您优先选用空间模型进行 IoT SaaS 应用开发。

  • 通用服务:针对 IoT SaaS 开发的场景涂鸦还提供了常见的通用基础服务,例如短信、邮件、天气预报等,让您一站式获取到所需的能力。

使用指南

详情请参考 API 使用指南

历史版本

云服务 API 于 2023 年 6 月进行了能力升级、业务整合和体验优化,其中部分 API 对应的分组和和文档目录有所调整,但历史客户的调用权限不会受到影响。

如果您希望查看到旧目录结构的 API 文档,您也可以查看 旧版云服务 API(已归档)

历史文档会一直保存归档,但可能不会及时更新,所以更加推荐您查看最新的 API 文档。