IoT Platform:Use IoT Platform SDK for .NET

Procedure

1. Initialize the SDK. For more information, see the Initialize the SDK section of this topic.

2. Create an API request by generating a request instance of the ${API operation name}+"Request" class.

3. Call the request.${Request parameter} method of the request instance to specify the request parameters.

4. Create a response instance of the ${API operation name}+"Response" class to obtain the response. Call the ${API operation name}(request) method of the client instance to obtain the response to the API request. The response includes the body and headers returned by the server.

5. Call the response.body.${Response parameter} method to obtain the values of response parameters.

   For example, you can call the response.body.RequestId method to obtain the unique identifier generated by Alibaba Cloud for an API request. RequestId is a common response parameter. Common response parameters also include Success, ErrorMessage, and Code.

6. Call the catch() method to handle exceptions.

For more information about the API operations of IoT Platform, see List of operations by function. For more information about the request parameters and response parameters of each API operation, see the API reference.

The following example shows how to call the Pub operation to publish a message to a topic. For more information about request parameters, see Pub.

AlibabaCloud.SDK.Iot20180120.Models.PubRequest request = new AlibabaCloud.SDK.Iot20180120.Models.PubRequest
{
    // The ID of the IoT Platform instance. 
    IotInstanceId = "${iotInstanceId}",
    // The ProductKey of the product. 
    ProductKey = "${productKey}",
    // The content of the message that you want to send. Encode "hello world" in Base64 as a string. 
    MessageContent = Convert.ToBase64String(Encoding.Default.GetBytes("Hello World.")),
    // The custom topic that is used to publish the message. 
    TopicFullName = "/${productKey}/${deviceName}/user/get",
    // The message sending mode. IoT Platform SDK supports QoS 0 and QoS 1. 
    Qos = 0,
};
// Obtain a response by using the client instance. 
try
{
    AlibabaCloud.SDK.Iot20180120.Models.PubResponse response = client.Pub(request);
    Console.WriteLine("publish message result: " + response.Body.Success);
    Console.WriteLine(response.Body.Code);
    Console.WriteLine(response.Body.ErrorMessage);
}
catch (TeaException error)
{
    Console.WriteLine(error.Code);
    Console.WriteLine(error.Message);
}
catch (Exception _error)
{
    Console.WriteLine(_error.Message);
    Console.WriteLine(_error.StackTrace);
}

Sample code

using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Threading.Tasks;

using Tea;
using Tea.Utils;

namespace AlibabaCloud.SDK.Sample
{
    public class Sample
    {
        /**
         * Use your AccessKey ID and AccessKey secret to initialize the client. 
         * @param accessKeyId 
         * @param accessKeySecret
         * @param regionId
         * @return Client
         * @throws Exception
         */
        public static AlibabaCloud.SDK.Iot20180120.Client CreateClient()
        {
            AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config();
            // Your AccessKey ID. 
            config.AccessKeyId = Environment.GetEnvironmentVariable("ACCESS_KEY_ID");
            // Your AccessKey secret. 
            config.AccessKeySecret = Environment.GetEnvironmentVariable("ACCESS_KEY_SECRET");
            // The region ID. 
            config.RegionId = "cn-shanghai";
            return new AlibabaCloud.SDK.Iot20180120.Client(config);
        }


        public static void Main(string[] args)
        {
            try
            {
                AlibabaCloud.SDK.Iot20180120.Client client = CreateClient("${accessKey}", "${accessKeySecret}");
                AlibabaCloud.SDK.Iot20180120.Models.PubRequest request = new AlibabaCloud.SDK.Iot20180120.Models.PubRequest
                {
                    // The ID of the IoT Platform instance. 
                    IotInstanceId = "${iotInstanceId}",
                    // The ProductKey of the product. 
                    ProductKey = "${productKey}",
                    // The content of the message that you want to send. Encode "hello world" in Base64 as a string. 
                    MessageContent = Convert.ToBase64String(Encoding.Default.GetBytes("Hello World.")),
                    // The custom topic that is used to publish the message. 
                    TopicFullName = "/${productKey}/${deviceName}/user/get",
                    // The message sending mode. IoT Platform SDK supports QoS 0 and QoS 1. 
                    Qos = 0,
                };
                AlibabaCloud.SDK.Iot20180120.Models.PubResponse response = client.Pub(request);
                Console.WriteLine("publish message result: " + response.Body.Success);
                Console.WriteLine(response.Body.Code);
                Console.WriteLine(response.Body.ErrorMessage);
            }
            catch (TeaException error)
            {
                Console.WriteLine(error.Code);
                Console.WriteLine(error.Message);
            }
            catch (Exception _error)
            {
                Console.WriteLine(_error.Message);
                Console.WriteLine(_error.StackTrace);
            }
        }
    }
}