集成SDK

更新时间: 2024-01-15 10:45:52

集成阿里云SDK主要有三步:设置访问凭据、引入阿里云SDK、编写调用代码。本文将以Go语言调用短信服务 SMS(Short Message Service)的发送短信接口为例,讲解完整的集成步骤。

环境要求

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

  • 安装 SDK 核心库 OpenAPI:

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

第一步:设置访问凭据

调用阿里云OpenAPI通常需要设置访问密钥(AccessKey),详情参见凭据。为了避免凭据泄露,常见的方案是将其写入到环境变量中,更多安全方案请参见凭据的安全使用方案。本案例以设置环境变量为例:

配置环境变量ALIBABA_CLOUD_ACCESS_KEY_IDALIBABA_CLOUD_ACCESS_KEY_SECRET

  • Linux和macOS系统配置方法

    命令行终端执行以下命令:

    export ALIBABA_CLOUD_ACCESS_KEY_ID=<ACCESS_KEY_ID>
    export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<ACCESS_KEY_SECRET>

    <access_key_id>需替换为已准备好的AccessKey ID,<access_key_secret>替换为AccessKey Secret。

  • Windows系统配置方法

    1. 新建环境变量文件,添加环境变量ALIBABA_CLOUD_ACCESS_KEY_IDALIBABA_CLOUD_ACCESS_KEY_SECRET,并写入已准备好的AccessKey ID和AccessKey Secret。

第二步:引入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{}

发起请求

升级版 SDK 中每个产品的 Client 包含了所有的 OpenAPI,所以可以指定 OpenAPI 请求方法来请求,其方法名对应 OpenAPI 首字母小写,一般有三个:

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

    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)
    }
    

阿里云首页 阿里云SDK 相关技术圈