使用前必读

概述

物联网平台把自身丰富的管理能力通过API的形式对外开放，包括产品管理、设备管理、设备组管理、标签管理、设备CA证书管理、设备影子、设备命令、设备消息、设备属性、订阅管理、规则管理、批量任务等，帮助用户快速构筑基于物联网平台的行业应用。您可以根据本文档提供的API来使用物联网平台的服务，平台支持的全部API请参见API列表。

角色说明

• 如果您是新用户，推荐使用应用侧API参考中的接口。
• 如果您是老用户，想继续使用老接口，请使用应用侧API参考中的接口。
• 如果您是老用户，想升级到新接口，请详细预览接口演进指导，完成改造后，再使用应用侧API参考中的接口。

调用说明

物联网平台提供了RESTful（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。

物联网平台的Endpoint请参见：地区和终端节点。

使用限制

• API的演进会保持前向兼容性，若接口升级了版本，其旧版本接口可以继续使用，但功能不再做增强，新增功能仅在新版本接口中提供。
• 应用在接收处理物联网平台发送的响应消息和推送消息时，需要兼容或忽略消息中的新增参数，不能因为消息中的新增参数导致应用的处理异常。
• 调用API的其他使用限制，请参见物联网平台的使用限制。