使用說明

• 云端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。