概述

使用说明

• 云端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. 选择设置数据同步。在云端接口调用区域中，显示了线上环境的AppKey和AppSecret。
   

调用示例

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