This article describes the structure of IoT Platform API requests and provides a sample request.
To send an IoT Platform API request, you must send an HTTP or HTTPS request to the IoT Platform endpoint.
A request uses the following syntax:
|Endpoint||The endpoint of the IoT Platform API. Set the value to
|Action||The name of the operation being performed. For example, to publish a message to a specified topic, you must set the Action parameter to Pub.|
|Parameters||The request parameters for the operation. Separate multiple parameters with ampersands
Request parameters include both common parameters and operation-specific parameters. Common parameters include information such as the API version number and authentication information.
https://iot.cn-shanghai.aliyuncs.com/?Action=Pub &Format=XML &Version=2017-04-20 &Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dgI%3D &SignatureMethod=HMAC-SHA1 &SignatureNonce=15215528852396 &SignatureVersion=1.0 &AccessKeyId=... &Timestamp=2017-07-19T12:00:00Z &RegionId=cn-shanghai ...
Alibaba Cloud provides OpenAPI Explorer to simplify API usage. You can use OpenAPI Explorer to search for API operations, call API operations, and dynamically generate the sample code of API operations for different SDKs. On the right side of the page, you can view the sample code of an SDK on the Example Code tab. On the Debugging Result tab, you can view the actual request URL and response in the JSON format.
To ensure the security of your Alibaba Cloud account, we recommend that you call API operations as a RAM user. Before you call an API operation as a RAM user, you must create and attach specific authorization policies to the RAM user to allow access to the API operation.
For more information, see API permissions.