Alibaba Cloud SDK:Integrate Alibaba Cloud Darabonba SDK for Go

Prerequisites

• Go 1.10.X or later is installed.

• The core package of Alibaba Cloud Darabonba SDK is installed.

  go get github.com/alibabacloud-go/darabonba-openapi/v2/client

Step 1: Configure a credential

Step 2: Import the SDK to your project

Alibaba Cloud Darabonba SDK allows you to make generic and specialized calls. For more information, see Generic calls and specialized calls. The SDK that you need to import varies based on the call type.

Specialized calls

You can visit OpenAPI Explorer, find the service that you want to use, and view the supported languages and installation methods. Then, import the SDK of the service to your project. In this example, SMS SDK is imported. Perform the following steps:

1. Visit the SMS SDK page.

2. In the All languages section, select the language that you want to use.

3. In the Installation Method section, select an installation method and copy the installation code.

4. Add the dependency to your project.

Run the following command to install SMS SDK for Go:

go get github.com/alibabacloud-go/dysmsapi-20170525/v3

Generic calls

You do not need to install the SDK of a service to make generic calls. You need to only import the github.com/alibabacloud-go/darabonba-openapi/v2/client core package. For information about the latest version of the core package, see darabonba-openapi. Run the following command to install the core package:

go get github.com/alibabacloud-go/darabonba-openapi/v2/client

Step 3: Call an API operation

Download the sample code. For more information, see Get started with Alibaba Cloud Darabonba SDK for Go. In this example, the sample code of a specialized call is used. If you want to make a generic call, turn on Common Request when you download the sample code. For more information, see Generic calls and specialized calls.

Initialize a request client

Method 1: Use an AccessKey pair

import (
	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
	dysmsapi20170525 "github.com/alibabacloud-go/dysmsapi-20170525/v3/client"
	"github.com/alibabacloud-go/tea/tea"
	"os"
)

func CreateClient() {
	config := &openapi.Config{
		// Required. Specify your AccessKey ID.
		AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
		// Required. Specify your AccessKey secret.
		AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
	}
	// Specify the endpoint. For more information, visit https://api.aliyun.com/product/Dysmsapi.
	config.Endpoint = tea.String("dysmsapi.aliyuncs.com")
	// Initialize a request client for a specialized call.
	dysmsapiClient, _err := dysmsapi20170525.NewClient(config)
}

Method 2: Use an STS token

import (
	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
	dysmsapi20170525 "github.com/alibabacloud-go/dysmsapi-20170525/v3/client"
	"github.com/alibabacloud-go/tea/tea"
	"os"
)

func CreateClient() {
	config := &openapi.Config{
		// Required. Specify your AccessKey ID.
		AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
		// Required. Specify your AccessKey secret.
		AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
		// Required. Specify your Security Token Service (STS) token.
		SecurityToken:   tea.String(os.Getenv("ALIBABA_CLOUD_SECURITY_TOKEN")),
	}
	// Specify the endpoint. For more information, visit https://api.aliyun.com/product/Dysmsapi.
	config.Endpoint = tea.String("dysmsapi.aliyuncs.com")
	// Initialize a request client for a specialized call.
	dysmsapiClient, _err := dysmsapi20170525.NewClient(config)
}

Method 3: Use the Credentials tool

import (
	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
	dysmsapi20170525 "github.com/alibabacloud-go/dysmsapi-20170525/v3/client"
	"github.com/alibabacloud-go/tea/tea"
	"github.com/aliyun/credentials-go/credentials"
)

func main() {
	// Use the default credential to initialize a Credentials client.
	credential, _err := credentials.NewCredential(nil)
	if _err != nil {
		panic(_err)
	}
	dysmsapiClient, _err := dysmsapi20170525.NewClient(&openapi.Config{
		// Use the SDK Credentials package to configure a credential.
		Credential: credential,
		// To call the SMS API, initialize the Client class of the SDK package for SMS.
		Endpoint: tea.String("dysmsapi.aliyuncs.com"),
	})
	if _err != nil {
		panic(_err)
	}
}

Create a request object or a runtime configuration object

In most cases, you can create a request object and specify the parameters based on your business requirements. You can also customize runtime configurations.

// Create a request object and specify the parameters.
sendSmsRequest := &dysmsapi20170525.SendSmsRequest{
	PhoneNumbers: tea.String("<YOUR_VALUE>"),
	SignName: tea.String("<YOUR_VALUE>"),
}
// Create a runtime configuration object.
runtime := &util.RuntimeOptions{}

Initiate a request

• <API operation name>: uses the default runtime configurations to initiate a request.

  package main
  
  import (
  	"fmt"
  	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
  	dysmsapi20170525 "github.com/alibabacloud-go/dysmsapi-20170525/v3/client"
  	"github.com/alibabacloud-go/tea/tea"
  	"github.com/aliyun/credentials-go/credentials"
  )
  
  func main() {
  	// Initialize a Credentials client. 
  	credentialClient, _err := credentials.NewCredential(nil)
  	if _err != nil {
  		panic(_err)
  	}
  	// Initialize a request client. 
  	smsClient, _err := dysmsapi20170525.NewClient(&openapi.Config{
  		// Use the SDK Credentials package to configure a credential. 
  		Credential: credentialClient,
  		// Specify the endpoint of the cloud service. 
  		Endpoint: tea.String("dysmsapi.aliyuncs.com"),
  	})
  	// Construct the request object.
  	sendSmsRequest := &dysmsapi20170525.SendSmsRequest{}
  	// Obtain the response object.
  	response, _err := smsClient.SendSms(sendSmsRequest)
  	fmt.Print(response)
  }
  

• <API operation name>WithOptions: uses the custom runtime configurations to initiate a request. For more information, see Advanced configuration.

  package main
  
  import (
  	"fmt"
  	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
  	dysmsapi20170525 "github.com/alibabacloud-go/dysmsapi-20170525/v3/client"
  	"github.com/alibabacloud-go/tea/tea"
  	"github.com/aliyun/credentials-go/credentials"
  	util "github.com/alibabacloud-go/tea-utils/v2/service"
  )
  
  func main() {
  	// Initialize a Credentials client. 
  	credentialClient, _err := credentials.NewCredential(nil)
  	if _err != nil {
  		panic(_err)
  	}
  	// Initialize a request client. 
  	smsClient, _err := dysmsapi20170525.NewClient(&openapi.Config{
  		// Use the SDK Credentials package to configure a credential. 
  		Credential: credentialClient,
  		// Specify the endpoint of the cloud service. 
  		Endpoint: tea.String("dysmsapi.aliyuncs.com"),
  	})
  	// Construct the request object.
  	sendSmsRequest := &dysmsapi20170525.SendSmsRequest{}
  	// Construct the runtime configuration object.
  	runtime := &util.RuntimeOptions{}
  	// Set the timeout period for read requests.
  	runtime.SetReadTimeout(10000)
  	// Set the timeout period for connection requests.
  	runtime.SetConnectTimeout(5000)
  	// Specify whether to automatically retry a request.
  	runtime.SetAutoretry(true)
  	// Obtain the response object.
  	response, _err := smsClient.SendSmsWithOptions(sendSmsRequest,runtime)
  	fmt.Print(response)
  }
  

• <API operation name>Advance: used for API operations that require file uploading. By default, you must specify runtime parameters. The following sample code provides an example on how to initiate a request to upload a file and call an API operation to use the human face and body recognition feature of Visual Intelligence API (VIAPI):

  go get github.com/alibabacloud-go/facebody-20191230/v4

  package main
  
  import (
  	"fmt"
  	"os"
  
  	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
  	facebody20191230 "github.com/alibabacloud-go/facebody-20191230/v4/client"
  	util "github.com/alibabacloud-go/tea-utils/v2/service"
  	"github.com/alibabacloud-go/tea/tea"
  	"github.com/aliyun/credentials-go/credentials"
  )
  
  func main() {
  	// Initialize a Credentials client. 
  	credentialClient, _err := credentials.NewCredential(nil)
  	if _err != nil {
  		panic(_err)
  	}
  	// Initialize a request client. 
  	facebodyClient, _err := facebody20191230.NewClient(&openapi.Config{
  		// Use the SDK Credentials package to configure a credential. 
  		Credential: credentialClient,
  		// Specify the endpoint of the cloud service. 
  		Endpoint: tea.String("facebody.cn-shanghai.aliyuncs.com"),
  	})
  	if _err != nil {
  		panic(_err)
  	}
  	file, _err := os.Open("<filepath>")
  	if _err != nil {
  		panic(_err)
  	}
  	// Initialize the request to call the DescribeRegions operation. 
  	detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
  		ImageURLObject: file,
  	}
  	// Initialize the runtime configurations. 
  	runtime := &util.RuntimeOptions{}
  	// Set the timeout period for read requests.
  	runtime.SetReadTimeout(10000)
  	// Set the timeout period for connection requests.
  	runtime.SetConnectTimeout(5000)
  	// Specify whether to automatically retry a request.
  	runtime.SetAutoretry(true)
  
  	response, _err := facebodyClient.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime)
  	if _err != nil {
  		panic(_err)
  	}
  	fmt.Print(response)
  }