SDK for Java

Last updated: 2020-10-16 11:42:04

    SDK 3.0 is a companion tool for the TencentCloud API 3.0 platform. You can use all SMS APIs through the SDK. The new SDK version is unified and features the same SDK usage, API call methods, error codes, and returned packet formats for different programming languages.

    Note:

    • SMS sending APIs
      One message can be sent to up to 200 numbers at a time.
    • Signature and body template APIs
      Individual users have no permission to use signature and body template APIs and can manage SMS signatures and SMS body templates only in the SMS Console. To use the APIs, change "Individual Identity" to "Organizational Identity".

    Prerequisites

    • You have activated SMS. For detailed directions, please see Getting Started with Mainland China SMS.
    • If you need to send SMS messages in Mainland China, you need to purchase a Mainland China SMS package first.
    • You have prepared the dependent environment: JDK 7 or above.
    • You have obtained the SecretID and SecretKey on the API Key Management page in the CAM Console.
      • SecretID is used to identify the API caller.
      • SecretKey is used to encrypt the string to sign that can be verified on the server. You should keep it private and avoid disclosure.
    • You have obtained the call address (endpoint). The call address of the SMS service is sms.tencentcloudapi.com.

    Relevant Documents

    • For more information on the APIs and their parameters, please see API Documentation.
    • You can download the SDK source code here.

    Installing SDK

    Installing through Maven (recommended)

    Maven is a dependency management tool for Java that supports the dependencies your project requires and installs them into your project.

    1. Go to Maven's official website to download the corresponding Maven installation package for your system and install it.
    2. Add Maven dependencies by adding the following dependencies in Maven's pom.xml:

      Note:

      The version number here is for demonstration only. Please get the latest version number in Maven Repository for replacement.

      <dependency>
           <groupId>com.tencentcloudapi</groupId>
           <artifactId>tencentcloud-sdk-java</artifactId>
           <version>3.1.62</version><!-- Note: the version number here is for demonstration only. Please get the latest version number for replacement -->
      </dependency>
    3. For importing methods, please see the sample code.

    Installing through source package

    1. Download the source code package.
    2. Decompress the source package to an appropriate location in your project.
    3. Put the jar package under the vendor directory in a path that can be found by Java.
    4. For importing methods, please see the sample code.

    Sample Code

    Note:

    All samples are for reference only and cannot be directly compiled and executed. You need to modify them based on your actual needs. You can also use API 3.0 Explorer to automatically generate the demo code as needed.

    Each API has a corresponding request structure and a response structure. This document only lists the sample code of several common features. For more samples, please see SDK for Java Samples.

    Applying for SMS template

    import com.tencentcloudapi.common.Credential;
    import com.tencentcloudapi.common.exception.TencentCloudSDKException;
    
    // Import the optional configuration classes
    import com.tencentcloudapi.common.profile.ClientProfile;
    import com.tencentcloudapi.common.profile.HttpProfile;
    
    // Import the client of the SMS module
    import com.tencentcloudapi.sms.v20190711.SmsClient;
    
    // Import the request response class corresponding to the request API
    import com.tencentcloudapi.sms.v20190711.models.AddSmsTemplateRequest;
    import com.tencentcloudapi.sms.v20190711.models.AddSmsTemplateResponse;
    
    /**
     * Tencent Cloud Sms Sendsms
     * https://intl.cloud.tencent.com/document/product/382/34859
     *
     */
    public class AddSmsTemplate
    {
        public static void main( String[] args )
        {
            try {
                /* Required steps:
                 * Instantiate an authentication object. The Tencent Cloud account key pair `secretId` and `secretKey` need to be passed in as the input parameters
                 * This example uses the way to read from the environment variable, so you need to set these two values in the environment variable in advance
                 * You can also write the key pair directly into the code, but be careful not to copy, upload, or share the code to others
                 * Query the CAM key: https://console.cloud.tencent.com/cam/capi*/
                Credential cred = new Credential("secretId", "secretKey");
    
                // Instantiate an HTTP option (optional; skip if there are no special requirements)
                HttpProfile httpProfile = new HttpProfile();
                // Set the proxy
                httpProfile.setProxyHost("host");
                httpProfile.setProxyPort(port);
                /* The SDK uses the POST method by default
                 * If you need to use the GET method, you can set it here, but the GET method cannot handle some large requests */
                httpProfile.setReqMethod("POST");
                /* The SDK has a default timeout period. Do not adjust it unless absolutely necessary
                 * If needed, check in the code to get the latest default value */
                httpProfile.setConnTimeout(60);
                /* The SDK automatically specifies the domain name. Generally, you don't need to specify a domain name, but if you are accessing a service in a finance AZ, you must manually specify the domain name
                 * For example, the SMS domain name of the Shanghai Finance Zone is `sms.ap-shanghai-fsi.tencentcloudapi.com` */
                httpProfile.setEndpoint("sms.tencentcloudapi.com");
    
                /* Optional steps:
                 * Instantiate a client configuration object. You can specify the timeout period and other configuration items */
                ClientProfile clientProfile = new ClientProfile();
                /* The SDK uses `TC3-HMAC-SHA256` to sign by default
                 * Do not modify this field unless absolutely necessary */
                clientProfile.setSignMethod("HmacSHA256");
                clientProfile.setHttpProfile(httpProfile);
                /* Instantiate an SMS client object
                 * The second parameter is the region information. You can directly enter the string `ap-guangzhou` or import the preset constant */
                SmsClient client = new SmsClient(cred, "",clientProfile);
                /* Instantiate a request object. You can further set the request parameters according to the API called and actual conditions
                 * You can directly check the SDK source code to determine which attributes of the API can be set
                 * An attribute may be of a basic type or import another data structure
                 * You are recommended to use the IDE for development where you can easily redirect to and view the documentation of each API and data structure */
                AddSmsTemplateRequest req = new AddSmsTemplateRequest();
    
                /* Populate the request parameters. Here, the member variables of the request object are the input parameters of the corresponding API
                 * You can view the definition of the request parameters in the API documentation at the official website or by redirecting to the definition of the request object
                 * Settings of a basic parameter:
                 * Help link:
                 * SMS Console: https://console.cloud.tencent.com/smsv2
                 * SMS Helper: https://intl.cloud.tencent.com/document/product/382/3773?from_cn_redirect=1 */
    
                /* Template name */
                String templatename = "Tencent Cloud";
                req.templateName(templatename);
    
                /* Template content */
                String templatecontent     = "Your login verification code is {1}. Please enter it within {2} minutes. If the login was not initiated by you, please ignore this message.";
                req.templateContent    (templatecontent);
    
                /* SMS type. 0: general SMS; 1: marketing SMS */
                Long smstype = 0;
                req.smsType(smstype);
    
                /* Whether it is Global SMS. 0: Mainland China SMS; 1: Global SMS */
                Long international = 0;
                req.international(session);
    
                /* Template remarks, such as reason for application and use case */
                String remark = "xxx";
                req.remark(remark);
    
                /* Initialize the request by calling the `AddSmsTemplate` method on the client object. Note: the request method name corresponds to the request object
                 * The returned `res` is an instance of the `AddSmsTemplateResponse` class which corresponds to the request object */
                AddSmsTemplateResponse res = client.AddSmsTemplate(req);
    
                // A string return packet in JSON format is output
                System.out.println(AddSmsTemplateResponse.toJsonString(res));
    
                // You can take a single value. You can view the definition of the return field in the API documentation at the official website or by redirecting to the definition of the response object
                System.out.println(res.getRequestId());
    
            } catch (TencentCloudSDKException e) {
                e.printStackTrace();
            }
        }
    }

    Sending SMS message

    import com.tencentcloudapi.common.Credential;
    import com.tencentcloudapi.common.exception.TencentCloudSDKException;
    
    // Import the optional configuration classes
    import com.tencentcloudapi.common.profile.ClientProfile;
    import com.tencentcloudapi.common.profile.HttpProfile;
    
    // Import the client of the SMS module
    import com.tencentcloudapi.sms.v20190711.SmsClient;
    
    // Import the request response class corresponding to the request API
    import com.tencentcloudapi.sms.v20190711.models.SendSmsRequest;
    import com.tencentcloudapi.sms.v20190711.models.SendSmsResponse;
    
    /**
     * Tencent Cloud Sms Sendsms
     * https://intl.cloud.tencent.com/document/product/382/34859
     *
     */
    public class SendSms
    {
        public static void main( String[] args )
        {
            try {
                /* Required steps:
                 * Instantiate an authentication object. The Tencent Cloud account key pair `secretId` and `secretKey` need to be passed in as the input parameters
                 * This example uses the way to read from the environment variable, so you need to set these two values in the environment variable in advance
                 * You can also write the key pair directly into the code, but be careful not to copy, upload, or share the code to others
                 * Query the CAM key: https://console.cloud.tencent.com/cam/capi*/
                Credential cred = new Credential("secretId", "secretKey");
    
                // Instantiate an HTTP option (optional; skip if there are no special requirements)
                HttpProfile httpProfile = new HttpProfile();
                // Set the proxy
                httpProfile.setProxyHost("host");
                httpProfile.setProxyPort(port);
                /* The SDK uses the POST method by default
                 * If you need to use the GET method, you can set it here, but the GET method cannot handle some large requests */
                httpProfile.setReqMethod("POST");
                /* The SDK has a default timeout period. Do not adjust it unless absolutely necessary
                 * If needed, check in the code to get the latest default value */
                httpProfile.setConnTimeout(60);
                /* The SDK automatically specifies the domain name. Generally, you don't need to specify a domain name, but if you are accessing a service in a finance AZ, you must manually specify the domain name
                 * For example, the SMS domain name of the Shanghai Finance Zone is `sms.ap-shanghai-fsi.tencentcloudapi.com` */
                httpProfile.setEndpoint("sms.tencentcloudapi.com");
    
                /* Optional steps:
                 * Instantiate a client configuration object. You can specify the timeout period and other configuration items */
                ClientProfile clientProfile = new ClientProfile();
                /* The SDK uses `TC3-HMAC-SHA256` to sign by default
                 * Do not modify this field unless absolutely necessary */
                clientProfile.setSignMethod("HmacSHA256");
                clientProfile.setHttpProfile(httpProfile);
                /* Instantiate an SMS client object
                 * The second parameter is the region information. You can directly enter the string `ap-guangzhou` or import the preset constant */
                SmsClient client = new SmsClient(cred, "",clientProfile);
                /* Instantiate a request object. You can further set the request parameters according to the API called and actual conditions
                 * You can directly check the SDK source code to determine which attributes of the API can be set
                 * An attribute may be of a basic type or import another data structure
                 * You are recommended to use the IDE for development where you can easily redirect to and view the documentation of each API and data structure */
                SendSmsRequest req = new SendSmsRequest();
    
                /* Populate the request parameters. Here, the member variables of the request object are the input parameters of the corresponding API
                 * You can view the definition of the request parameters in the API documentation at the official website or by redirecting to the definition of the request object
                 * Settings of a basic parameter:
                 * Help link:
                 * SMS Console: https://console.cloud.tencent.com/smsv2
                 * SMS helper: https://intl.cloud.tencent.com/document/product/382/3773 */
    
                /* SMS application ID, which is the actual `SDKAppID` generated after an application is added in the [SMS Console], such as 1400006666 */
                String appid = "1400009099";
                req.setSmsSdkAppid(appid);
    
                /* The content of SMS signature should be encoded in UTF-8. You must enter an approved signature, which can be viewed in the [SMS Console] */
                String sign = "Signing information";
                req.setSign(sign);
    
                /* `senderid` for global SMS, which is not activated by default. If you need to activate it, please contact [SMS Helper] for assistance. This parameter should be left empty for Mainland China SMS */
                String senderid = "xxx";
                req.setSenderId(senderid);
    
                /* User session content, which can carry context information such as user-side ID and will be returned as-is by the server */
                String session = "xxx";
                req.setSessionContext(session);
    
                /* SMS code number extension, which is not activated by default. If you need to activate it, please contact [SMS Helper] */
                String extendcode = "xxx";
                req.setExtendCode(extendcode);
    
                /* Template ID. You must enter the ID of an approved template, which can be viewed in the [SMS Console] */
                String templateID = "400000";
                req.setTemplateID(templateID);
    
                /* Target mobile number in the e.164 standard (+[country/region code][mobile number])
                 * Example: +8613711112222, which has a + sign followed by 86 (country/region code) and then by 13711112222 (mobile number). Up to 200 mobile numbers are supported */
                String[] phoneNumbers = {"+8621212313123", "+8612345678902", "+8612345678903"};
                req.setPhoneNumberSet(phoneNumbers);
    
                /* Template parameters. If there are no template parameters, leave it empty */
                String[] templateParams = {"5678"};
                req.setTemplateParamSet(templateParams);
    
                /* Initialize the request by calling the `SendSms` method on the client object. Note: the request method name corresponds to the request object
                 * The returned `res` is an instance of the `SendSmsResponse` class which corresponds to the request object */
                SendSmsResponse res = client.SendSms(req);
    
                // A string return packet in JSON format is output
                System.out.println(SendSmsResponse.toJsonString(res));
    
                // You can take a single value. You can view the definition of the return field in the API documentation at the official website or by redirecting to the definition of the response object
                System.out.println(res.getRequestId());
    
            } catch (TencentCloudSDKException e) {
                e.printStackTrace();
            }
        }
    } 

    Pulling receipt status

    import com.tencentcloudapi.common.Credential;
    import com.tencentcloudapi.common.exception.TencentCloudSDKException;
    
    // Import the optional configuration classes
    import com.tencentcloudapi.common.profile.ClientProfile;
    import com.tencentcloudapi.common.profile.HttpProfile;
    
    // Import the client of the SMS module
    import com.tencentcloudapi.sms.v20190711.SmsClient;
    
    // Import the request response class corresponding to the request API
    import com.tencentcloudapi.sms.v20190711.models.PullSmsSendStatusRequest;
    import com.tencentcloudapi.sms.v20190711.models.PullSmsSendStatusResponse;
    
    /**
     * Tencent Cloud Sms PullSmsSendStatus
     * https://intl.cloud.tencent.com/document/product/382/34841
     *
     */
    public class PullSmsSendStatus {
        public static void main(String[] args) {
            try {
                /* Required steps:
                 * Instantiate an authentication object. The Tencent Cloud account key pair `secretId` and `secretKey` need to be passed in as the input parameters
                 * This example uses the way to read from the environment variable, so you need to set these two values in the environment variable in advance
                 * You can also write the key pair directly into the code, but be careful not to copy, upload, or share the code to others
                 * Query the CAM key: https://console.cloud.tencent.com/cam/capi */
                Credential cred = new Credential("secretId", "secretKey");
    
                // Instantiate an HTTP option (optional; skip if there are no special requirements)
                HttpProfile httpProfile = new HttpProfile();
                // Set the proxy
                httpProfile.setProxyHost("host");
                httpProfile.setProxyPort(port);
                /* The SDK uses the POST method by default
                 * If you need to use the GET method, you can set it here, but the GET method cannot handle some large requests */
                httpProfile.setReqMethod("POST");
                /* The SDK has a default timeout period. Do not adjust it unless absolutely necessary
                 * If needed, check in the code to get the latest default value */
                httpProfile.setConnTimeout(60);
                /* The SDK automatically specifies the domain name. Generally, you don't need to specify a domain name, but if you are accessing a service in a finance AZ, you must manually specify the domain name
                 * For example, the SMS domain name of the Shanghai Finance Zone is `sms.ap-shanghai-fsi.tencentcloudapi.com` */
                httpProfile.setEndpoint("sms.tencentcloudapi.com");
    
                /* Optional steps:
                 * Instantiate a client configuration object. You can specify the timeout period and other configuration items */
                ClientProfile clientProfile = new ClientProfile();
                /* The SDK uses `TC3-HMAC-SHA256` to sign by default
                 * Do not modify this field unless absolutely necessary */
                clientProfile.setSignMethod("HmacSHA256");
                clientProfile.setHttpProfile(httpProfile);
    
                /* Instantiate an SMS client object
                 * The second parameter is the region information. You can directly enter the string `ap-guangzhou` or import the preset constant */
                SmsClient client = new SmsClient(cred, "",clientProfile);
    
                /* Instantiate a request object. You can further set the request parameters according to the API called and actual conditions
                 * You can directly check the SDK source code to determine which attributes of the API can be set
                 * An attribute may be of a basic type or import another data structure
                 * You are recommended to use the IDE for development where you can easily redirect to and view the documentation of each API and data structure */
                PullSmsSendStatusRequest req = new PullSmsSendStatusRequest();
    
                /* Populate the request parameters. Here, the member variables of the request object are the input parameters of the corresponding API
                 * You can view the definition of the request parameters in the API documentation at the official website or by redirecting to the definition of the request object
                 * Settings of a basic parameter:
                 * Help link:
                 * SMS Console: https://console.cloud.tencent.com/smsv2
                 * SMS helper: https://intl.cloud.tencent.com/document/product/382/3773 */
    
                /* SMS application ID, which is the actual `SDKAppID` generated after an application is added in the [SMS Console], such as 1400006666 */
                String appid = "1400009099";
                req.setSmsSdkAppid(appid);
    
                // Set the maximum number of pulled entries. Maximum value: 100
                Long limit = 5L;
                req.setLimit(limit);
    
                /* Initialize the request by calling the `PullSmsSendStatus` method on the client object. Note: the request method name corresponds to the request object
                 * The returned `res` is an instance of the `PullSmsSendStatusResponse` class which corresponds to the request object */
                PullSmsSendStatusResponse res = client.PullSmsSendStatus(req);
    
                // A string return packet in JSON format is output
                System.out.println(PullSmsSendStatusResponse.toJsonString(res));
    
            } catch (TencentCloudSDKException e) {
                e.printStackTrace();
            }
        }
    }

    Collecting SMS message sending data

    import com.tencentcloudapi.common.Credential;
    import com.tencentcloudapi.common.exception.TencentCloudSDKException;
    
    // Import the optional configuration classes
    import com.tencentcloudapi.common.profile.ClientProfile;
    import com.tencentcloudapi.common.profile.HttpProfile;
    
    // Import the client of the SMS module
    import com.tencentcloudapi.sms.v20190711.SmsClient;
    
    // Import the request response class corresponding to the request API
    import com.tencentcloudapi.sms.v20190711.models.SendStatusStatisticsRequest;
    import com.tencentcloudapi.sms.v20190711.models.SendStatusStatisticsResponse;
    
    /**
     * Tencent Cloud Sms SendStatusStatistics
     * https://intl.cloud.tencent.com/document/product/382/34841
     *
     */
    public class SendStatusStatistics {
        public static void main(String[] args) {
            try {
                /* Required steps:
                 * Instantiate an authentication object. The Tencent Cloud account key pair `secretId` and `secretKey` need to be passed in as the input parameters
                 * This example uses the way to read from the environment variable, so you need to set these two values in the environment variable in advance
                 * You can also write the key pair directly into the code, but be careful not to copy, upload, or share the code to others
                 * Query the CAM key: https://console.cloud.tencent.com/cam/capi */
                Credential cred = new Credential("secretId", "secretKey");
    
                // Instantiate an HTTP option (optional; skip if there are no special requirements)
                HttpProfile httpProfile = new HttpProfile();
                // Set the proxy
                httpProfile.setProxyHost("host");
                httpProfile.setProxyPort(port);
                /* The SDK uses the POST method by default
                 * If you need to use the GET method, you can set it here, but the GET method cannot handle some large requests */
                httpProfile.setReqMethod("POST");
                /* The SDK has a default timeout period. Do not adjust it unless absolutely necessary
                 * If needed, check in the code to get the latest default value */
                httpProfile.setConnTimeout(60);
                /* The SDK automatically specifies the domain name. Generally, you don't need to specify a domain name, but if you are accessing a service in a finance AZ, you must manually specify the domain name
                 * For example, the SMS domain name of the Shanghai Finance Zone is `sms.ap-shanghai-fsi.tencentcloudapi.com` */
                httpProfile.setEndpoint("sms.tencentcloudapi.com");
    
                /* Optional steps:
                 * Instantiate a client configuration object. You can specify the timeout period and other configuration items */
                ClientProfile clientProfile = new ClientProfile();
                /* The SDK uses `TC3-HMAC-SHA256` to sign by default
                 * Do not modify this field unless absolutely necessary */
                clientProfile.setSignMethod("HmacSHA256");
                clientProfile.setHttpProfile(httpProfile);
    
                /* Instantiate an SMS client object
                 * The second parameter is the region information. You can directly enter the string `ap-guangzhou` or import the preset constant */
                SmsClient client = new SmsClient(cred, "",clientProfile);
    
                /* Instantiate a request object. You can further set the request parameters according to the API called and actual conditions
                 * You can directly check the SDK source code to determine which attributes of the API can be set
                 * An attribute may be of a basic type or import another data structure
                 * You are recommended to use the IDE for development where you can easily redirect to and view the documentation of each API and data structure */
                SendStatusStatisticsRequest req = new SendStatusStatisticsRequest();
    
                /* Populate the request parameters. Here, the member variables of the request object are the input parameters of the corresponding API
                 * You can view the definition of the request parameters in the API documentation at the official website or by redirecting to the definition of the request object
                 * Settings of a basic parameter:
                 * Help link:
                 * SMS Console: https://console.cloud.tencent.com/smsv2
                 * SMS helper: https://intl.cloud.tencent.com/document/product/382/3773 */
    
                /* SMS application ID, which is the actual `SDKAppID` generated after an application is added in the [SMS Console], such as 1400006666 */
                String appid = "1400009099";
                req.setSmsSdkAppid(appid);
    
                // Set the maximum number of pulled entries. Maximum value: 100
                Long limit = 5L;
                req.setLimit(limit);
                /* Offset, which is currently fixed at 0 */
                Long offset = 0L;
                req.setOffset(offset);
                /* Start time of pull in the format of `yyyymmddhh` accurate to the hour */
                String startdatetime = "2019071100";
                req.setStartDateTime(startdatetime);
                /* End time of pull in the format of `yyyymmddhh` accurate to the hour
                 * Note: `EndDataTime` must be later than `StartDateTime` */
                String enddatatime = "2019071123"
                req.setEndDataTime(enddatatime);
    
                /* Initialize the request by calling the `SendStatusStatistics` method on the client object. Note: the request method name corresponds to the request object
                 * The returned `res` is an instance of the `SendStatusStatisticsResponse` class which corresponds to the request object */
                SendStatusStatisticsResponse res = client.SendStatusStatisticsStatus(req);
    
                // A string return packet in JSON format is output
                System.out.println(SendStatusStatisticsStatusResponse.toJsonString(res));
    
            } catch (TencentCloudSDKException e) {
                e.printStackTrace();
            }
        }
    }

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help