本文主要介紹調用物聯網平台雲端API的請求結構和請求樣本。
請求結構
您可以通過發送HTTP或HTTPS請求調用物聯網平台API。
請求結構如下：
http://Endpoint/?Action=****&Parameters參數 | 說明 |
Endpoint | 調用雲端服務的接入地址。物聯網平台的接入地址格式： |
Action | 要執行的操作，即雲端API的介面名稱。例如，調用Pub介面向指定Topic發布訊息，Action對應的值就是Pub，即 |
Parameters | 調用API的請求參數。每個參數之間用（&）符號分隔。 請求參數由公用請求參數和API自訂請求參數組成。公用參數中包含API版本號碼、身分識別驗證等資訊。 |
請求樣本
下文以調用2018-01-20版本的Pub介面向指定Topic發布訊息為例：
本文檔樣本均使用華東2（上海）地區的接入地址。為了便於閱讀，程式碼範例均做了格式化處理。請求參數說明，請參見公用參數和Pub。
其中AccessKeyId欄位，修改為您阿里雲帳號或RAM 使用者的 建立AccessKey。
阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。請妥善保管好您的AccessKey資訊。
強烈建議不要將AccessKey ID和AccessKey Secret儲存到工程代碼裡或者任何容易被泄露的地方，AccessKey泄露會威脅您帳號下所有資源的安全。
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=yourAccessKeyID
&Timestamp=2017-07-19T12:00:00Z
&RegionId=cn-shanghai
...API線上調試
阿里雲OpenAPI開發人員門戶提供OpenAPI Explorer。在API調試頁面，您可以快速檢索和體驗調用API。系統會根據您輸入的參數同步產生各語言SDK的程式碼範例。各語言SDK程式碼範例顯示在頁面右側SDK樣本頁簽下供您參考。在調用結果頁簽下，可查看API調用的真實請求URL和JSON格式的返回結果。
