集成SDK

环境要求

• Go环境版本 >= 1.10.x。

• 安装 SDK 核心库 OpenAPI：

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

第一步：设置访问凭据

第二步：引入SDK

阿里云SDK支持泛化与特化两种方式调用OpenAPI，详情参见泛化调用与特化调用，不同的调用方式需要引入的SDK也不同。

特化调用

您可以访问OpenAPI门户网站，搜索您需要的产品，查看产品支持的SDK语言及安装方法，然后在您的项目中引入SDK。本案例的SDK获取步骤如下：

1. 访问短信服务SDK。

2. 在所有语言栏目中选择您需要的SDK语言。

3. 选择您需要的安装方式，将代码复制到您的项目中。

4. 在您的项目中载入该依赖包。

其Go语言安装产品如下：

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

泛化调用

泛化调用方式不依赖任何一个产品的SDK，只依赖如下核心包github.com/alibabacloud-go/darabonba-openapi/v2/client。其Python语言安装产品如下，最新版本请参见darabonba-openapi。

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

第三步：调用OpenAPI

您可以根据快速开始文档下载示例代码。下面我们以特化调用代码为例，讲解调用过程。如果您选择泛化调用方案，请打开Common模式生成示例的开关，更多信息请参见泛化调用与特化调用。

初始化请求客户端

方法一：使用AK初始化

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{
		// 必填，您的 AccessKey ID
		AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
		// 必填，您的 AccessKey Secret
		AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
	}
	// Endpoint 请参考 https://api.aliyun.com/product/Dysmsapi
	config.Endpoint = tea.String("dysmsapi.aliyuncs.com")
	// 特化请求客户端
	dysmsapiClient, _err := dysmsapi20170525.NewClient(config)
}

方法二：使用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{
		// 必填，您的 AccessKey ID
		AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
		// 必填，您的 AccessKey Secret
		AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
		// 必填，您的STS Token
		SecurityToken:   tea.String(os.Getenv("ALIBABA_CLOUD_SECURITY_TOKEN")),
	}
	// Endpoint 请参考 https://api.aliyun.com/product/Dysmsapi
	config.Endpoint = tea.String("dysmsapi.aliyuncs.com")
	// 特化请求客户端
	dysmsapiClient, _err := dysmsapi20170525.NewClient(config)
}

方法三：使用Credentials工具初始化

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() {
	// 使用默认凭证初始化Credentials Client
	credential, _err := credentials.NewCredential(nil)
	if _err != nil {
		panic(_err)
	}
	dysmsapiClient, _err := dysmsapi20170525.NewClient(&openapi.Config{
		// 使用Credential配置凭证
		Credential: credential,
		// 若接入dysmsapi即短信服务，则初始化dysmsapi产品包的Client类
		Endpoint: tea.String("dysmsapi.aliyuncs.com"),
	})
	if _err != nil {
		panic(_err)
	}
}

创建请求对象&运行时配置

通常您需要根据业务的实际需要传入参数，您也可自定义运行时配置。

// 创建请求对象并设置入参
sendSmsRequest := &dysmsapi20170525.SendSmsRequest{
	PhoneNumbers: tea.String("<YOUR_VALUE>"),
	SignName: tea.String("<YOUR_VALUE>"),
}
// 创建运行时配置对象
runtime := &util.RuntimeOptions{}

发起请求

• <接口名称>：使用默认的运行时配置发起接口调用。

  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() {
  	// 初始化Credential。
  	credentialClient, _err := credentials.NewCredential(nil)
  	if _err != nil {
  		panic(_err)
  	}
  	// 初始化Client。
  	smsClient, _err := dysmsapi20170525.NewClient(&openapi.Config{
  		// 使用Credential配置凭证。
  		Credential: credentialClient,
  		// 配置云产品服务接入地址（endpoint）。
  		Endpoint: tea.String("dysmsapi.aliyuncs.com"),
  	})
  	// 构造请求对象
  	sendSmsRequest := &dysmsapi20170525.SendSmsRequest{}
  	// 获取响应对象
  	response, _err := smsClient.SendSms(sendSmsRequest)
  	fmt.Print(response)
  }
  

• <接口名称>WithOptions：可配置自定义运行时参数发起接口调用，更多运行时参数配置请参见进阶配置。

  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() {
  	// 初始化Credential。
  	credentialClient, _err := credentials.NewCredential(nil)
  	if _err != nil {
  		panic(_err)
  	}
  	// 初始化Client。
  	smsClient, _err := dysmsapi20170525.NewClient(&openapi.Config{
  		// 使用Credential配置凭证。
  		Credential: credentialClient,
  		// 配置云产品服务接入地址（endpoint）。
  		Endpoint: tea.String("dysmsapi.aliyuncs.com"),
  	})
  	// 构造请求对象
  	sendSmsRequest := &dysmsapi20170525.SendSmsRequest{}
  	// 构造运行时参数对象
  	runtime := &util.RuntimeOptions{}
  	//  读取超时
  	runtime.SetReadTimeout(10000)
  	// 连接超时
  	runtime.SetConnectTimeout(5000)
  	// 是否自动重试
  	runtime.SetAutoretry(true)
  	// 获取响应对象
  	response, _err := smsClient.SendSmsWithOptions(sendSmsRequest,runtime)
  	fmt.Print(response)
  }
  

• <接口名称>Advance：专门用于应对直接上传Object 的场景，该方法默认需要传入运行时参数。下述示例以视觉智能开放平台人体人脸产品为例介绍SDK如何使用本地文件上传调用 API。

  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() {
  	// 初始化Credential。
  	credentialClient, _err := credentials.NewCredential(nil)
  	if _err != nil {
  		panic(_err)
  	}
  	// 初始化Client。
  	facebodyClient, _err := facebody20191230.NewClient(&openapi.Config{
  		// 使用Credential配置凭证。
  		Credential: credentialClient,
  		// 配置云产品服务接入地址（endpoint）。
  		Endpoint: tea.String("facebody.cn-shanghai.aliyuncs.com"),
  	})
  	if _err != nil {
  		panic(_err)
  	}
  	file, _err := os.Open("<filepath>")
  	if _err != nil {
  		panic(_err)
  	}
  	// 初始化DescribeRegions请求。
  	detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
  		ImageURLObject: file,
  	}
  	// 初始化运行时配置。
  	runtime := &util.RuntimeOptions{}
  	//  读取超时
  	runtime.SetReadTimeout(10000)
  	// 连接超时
  	runtime.SetConnectTimeout(5000)
  	// 是否自动重试
  	runtime.SetAutoretry(true)
  
  	response, _err := facebodyClient.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime)
  	if _err != nil {
  		panic(_err)
  	}
  	fmt.Print(response)
  }