.NET SDK guide

Call steps

1. Initialize the SDK client. For more information, see SDK initialization.

2. Create a request instance of the ${API_Name}+"Request" class for the API call.

3. Set the required request parameters on the request instance in the request.${parameter_name} format.

4. Call the ${API_Name}(request) method of the client instance to send the request. The method returns a response instance of the ${API_Name}+"Response" class, which contains the body and headers from the server.

5. Retrieve the return parameter values from the body member of the response instance in the response.body.${return_parameter_name} format.

   For example, use response.body.RequestId to retrieve the unique identifier that Alibaba Cloud generates for the API request. RequestId is a common return parameter, along with Success, ErrorMessage, and Code.

6. You can use the catch() method to handle exceptions.

For more information about IoT Platform cloud APIs, see API list. For descriptions of the request parameters in the request and the response parameters in the response, see the documentation for the specific API.

This topic uses the Pub API as an example to show how to publish a message to a topic. For 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 message body to send, which is a Base64-encoded string of "Hello World."
    MessageContent = Convert.ToBase64String(Encoding.Default.GetBytes("Hello World.")),
    // The custom topic of the device that receives the message.
    TopicFullName = "/${productKey}/${deviceName}/user/get",
    // The method to send the message. QoS 0 and QoS 1 are supported.
    Qos = 0,
};
// Obtain the response object for the corresponding request from the client object.
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);
}

Complete code example

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
    {
        /**
         * Initialize the client using an AccessKey ID and an AccessKey secret.
         * @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");
            // Your 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();
                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 message body to send, which is a Base64-encoded string of "Hello World."
                    MessageContent = Convert.ToBase64String(Encoding.Default.GetBytes("Hello World.")),
                    // The custom topic of the device that receives the message.
                    TopicFullName = "/${productKey}/${deviceName}/user/get",
                    // The method to send the message. QoS 0 and QoS 1 are supported.
                    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);
            }
        }
    }
}