本文主要介紹調用物聯網平臺云端API的請求結構和請求示例。

請求結構

您可以通過發送HTTP或HTTPS請求調用物聯網平臺API。

請求結構如下：

http://Endpoint/?Action=****&Parameters
參數說明
Endpoint調用云服務的接入地址。物聯網平臺的接入地址格式：iot.${RegionId}.aliyuncs.com。其中，變量${RegionId}需替換為您的物聯網平臺服務的地域代碼。阿里云地域代碼，請參見支持的地域。
Action要執行的操作，即云端API的接口名稱。例如，調用Pub接口向指定Topic發布消息，Action對應的值就是Pub，即Action=Pub。
Parameters調用API的請求參數。每個參數之間用（&）符號分隔。

請求參數由公共請求參數和API自定義請求參數組成。公共參數中包含API版本號、身份驗證等信息。

請求示例

下文以調用2018-01-20版本的Pub接口向指定Topic發布消息為例：
說明 本文檔示例均使用華東2（上海）地域的接入地址。為了便于閱讀，代碼示例均做了格式化處理。請求參數說明，請參見公共參數和Pub。
https://iot.cn-shanghai.aliyuncs.com/?Action=Pub
&Format=XML
&Version=2018-01-20
&Signature=Pc5WB8gok***1dgI%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=15215528852396
&SignatureVersion=1.0
&AccessKeyId=LTAI4***iW5j3
&Timestamp=2017-07-19T12:00:00Z
&RegionId=cn-shanghai
...

API在線調試

阿里云OpenAPI開發者門戶提供API調試工具。在API調試頁面，您可以快速檢索和體驗調用API。系統會根據您輸入的參數同步生成各語言SDK的代碼示例。各語言SDK代碼示例顯示在頁面右側SDK示例頁簽下供您參考。在調用結果頁簽下，可查看API調用的真實請求URL和JSON格式的返回結果。

物聯網平臺API