当您自己的云端(web应用或服务)需要调用生活物联网平台提供的云端API时,您需要先了解调用的使用说明、云云交互流程、获取云端唯一身份AppKey的方法、以及调用云端API的示例。

使用说明

  • 云端API使用的AppKey与App端使用的AppKey不一致,但是访问环境一致。获取云端AppKey的方法参见本文档下方内容。
  • 基于安全考虑,所有云端API调用请使用HTTPS方式,不推荐HTTP方式。
  • 所有的API均为POST调用。

云端调用流程介绍

您自己的云端(web应用或服务)调用生活物联网平台提供的云端API时,与阿里云IoT云端(服务端)之间的交互流程如下图所示。

流程

流程说明如下。

  1. 您的云端通过调用获取云端资源Token向阿里云IoT云端请求资源令牌(Cloud Token);阿里云IoT云端收到请求后向您返回Cloud Token,及其对应的失效时间。

    阿里云IoT云端以项目(Project)维度授予Cloud Token,即不同项目的Cloud Token不同。申请Cloud Token时,需携带项目ID。

  2. 您的云端使用获取到的Cloud Token调用阿里云IoT云端某个具体的API;阿里云IoT云端向您返回请求的处理结果。
  3. 在Cloud Token失效前,您的云端通过调用刷新云端资源Token接口对当前Cloud Token进行续期。

    如果Cloud Token已经失效,则需重新调用获取云端资源Token接口来获取新的Cloud Token及其对应的失效时间。

获取云端Appkey

请您根据以下操作获取云端唯一身份AppKey。

  1. 登录生活物联网控制台
  2. 选择项目名称,并单击项目设置
    项目设置
  3. (可选)如果您的账户还没完成授权,此时界面弹出权限授权许可对话框,您需要为平台授权。
    1. 权限授权许可对话框中,单击确认
      权限授权许可
    2. 云资源访问授权页面,单击同意授权
      云资源授权页面
  4. 选择设置数据同步。在云端接口调用区域中,显示了线上环境的AppKeyAppSecret
    设备数据同步

调用示例

生活物联网平台提供了多种语言的云端API调用示例,详细调用示例请参见如何调用云端API