本文档主要介绍调用物联网平台云端API的请求结构和请求示例。

请求结构

您可以通过发送HTTP或HTTPS请求调用物联网平台API。

请求结构如下：

http://Endpoint/?Action=xx&Parameters
参数 说明
Endpoint 调用云服务的接入地址。物联网平台的接入地址格式：iot.${RegionId}.aliyuncs.com。其中，变量${RegionId}需替换为您的物联网平台服务的地域代码。阿里云地域代码，请参见地域和可用区。

接入地址示例：

  • 华东2（上海）：iot.cn-shanghai.aliyuncs.com
  • 新加坡：iot.ap-southeast-1.aliyuncs.com
  • 美国（硅谷）：iot.us-west-1.aliyuncs.com
  • 日本（东京）：iot.ap-northeast-1.aliyuncs.com
  • 德国（法兰克福）：iot.eu-central-1.aliyuncs.com
Action 要执行的操作，即云端API接口的名称。例如，调用Pub接口向指定Topic发布消息，Action对应的值就是Pub，即Action=Pub。
Parameters 请求参数。每个参数之间用（&）符号分隔。

请求参数由公共请求参数和API自定义参数组成。公共参数中包含API版本号、身份验证等信息。

下面以调用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

API授权

为了确保您的账号安全，建议您使用RAM用户调用API。如果您使用RAM用户调用物联网平台API，您需要为该RAM用户创建、授予相应的授权策略。

为RAM用户授权调用API，请参见IoT API 授权映射表。