集成SDK

1. 登录SDK中心，选择将要使用产品，例如您将要调用短信服务 SMS（Short Message Service）的API。

2. 在安装页面，SDK 代系选择V2.0，所有语言选择Go。然后在快速入门页签中，您可以获取短信服务 SMS（Short Message Service）的SDK安装方式。

特殊场景：文件上传Advance接口配置

在使用图像搜索、视觉智能开放平台等云产品处理本地图片或上传图片时，官方文档中提供的OpenAPI接口不支持直接上传文件。若需上传文件，可以使用云产品提供的Advance接口，该接口支持传递文件流对象。其底层实现机制为：云产品会将上传的文件临时存储于阿里云OSS上，默认存储地域为cn-shanghai，并通过读取该OSS中的临时文件来实现相关功能。以阿里云提供的视觉智能开放平台-人脸人体的DetectBodyCount接口为例：

1. 初始化请求客户端

   请注意需同时设置RegionId和云产品的Endpoint。其中，RegionId表示临时文件在OSS中所存储的地域。如果未设置RegionId，可能会由于云产品与OSS所在地域不同，导致在调用OpenAPI时出现超时等问题。

   func CreateClient() (_result *facebody20191230.Client, _err error) {
   
   	config := &openapi.Config{
   		// 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。
   		AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
   		// 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
   		AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
   	}
   	// endpoint 和 regionId 需设置为同一地域
   	config.RegionId = tea.String("cn-shanghai")
   	config.Endpoint = tea.String("facebody.cn-shanghai.aliyuncs.com")
   	_result, _err = facebody20191230.NewClient(config)
   	return _result, _err
   }

2. 创建请求对象

   通过创建<OpenAPI名称>AdvanceRequest请求对象传递文件流，参数名固定为ImageURLObject。

           // 需替换文件路径
   	filePath := `<FILE_PATH>`
   	// 打开文件并创建流
   	file, err := os.Open(filePath)
   	if err != nil {
   		return fmt.Errorf("打开文件失败: %v", err)
   	}
   	defer file.Close() // 关闭文件
   	// 创建请求对象
   	detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
   		ImageURLObject: file,
   	}

3. 发起请求

   需调用函数<接口名称>Advance发起请求。

   // 声明响应变量
   var response *facebody20191230.DetectBodyCountResponse 
   client, _err := CreateClient()
   if _err != nil {
       return _err
   }
   runtime := &util.RuntimeOptions{}
   // 发起请求
   response, _err = client.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime)
   fmt.Println(response)
   if _err != nil {
     return _err
   }

package main

import (
	"encoding/json"
	"fmt"
	"os"
	"strings"

	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
	facebody20191230 "github.com/alibabacloud-go/facebody-20191230/v5/client"
	util "github.com/alibabacloud-go/tea-utils/v2/service"
	"github.com/alibabacloud-go/tea/tea"
)

func CreateClient() (_result *facebody20191230.Client, _err error) {

	config := &openapi.Config{
		// 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。
		AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
		// 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
		AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
	}
	config.RegionId = tea.String("cn-shanghai")
	config.Endpoint = tea.String("facebody.cn-shanghai.aliyuncs.com")
	_result, _err = facebody20191230.NewClient(config)
	return _result, _err
}

func _main() (_err error) {
client, _err := CreateClient()
if _err != nil {
   return _err
}

// 需替换文件路径
filePath := `<FILE_PATH>`
// 打开文件并创建流
file, err := os.Open(filePath)
if err != nil {
    return fmt.Errorf("打开文件失败: %v", err)
}
defer file.Close() // 关闭文件
// 创建请求对象
detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
     ImageURLObject: file,
}
runtime := &util.RuntimeOptions{}
tryErr := func() (_e error) {
defer func() {
   if r := tea.Recover(recover()); r != nil {
	_e = r
   }
}()
var response *facebody20191230.DetectBodyCountResponse // 声明响应变量
// 发起请求
response, _err = client.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime)
fmt.Println(response)
if _err != nil {
   return _err
}

   return nil
}()

if tryErr != nil {
var error = &tea.SDKError{}
if _t, ok := tryErr.(*tea.SDKError); ok {
	error = _t
} else {
	error.Message = tea.String(tryErr.Error())
}
// 此处仅做打印展示，请谨慎对待异常处理，在工程项目中切勿直接忽略异常。
// 错误 message
fmt.Println(tea.StringValue(error.Message))
// 诊断地址
var data interface{}
d := json.NewDecoder(strings.NewReader(tea.StringValue(error.Data)))
d.Decode(&data)
if m, ok := data.(map[string]interface{}); ok {
	recommend, _ := m["Recommend"]
	fmt.Println(recommend)
}
_, _err = util.AssertAsString(error.Message)
if _err != nil {
     return _err
	}
}
     return _err
}

func main() {
	err := _main()
	if err != nil {
		panic(err)
	}
}

常见问题

1. 调用OpenAPI时报错，提示“You are not authorized to perform this operation”。

   问题原因及解决方法

   问题原因：您所使用的AccessKey对应的RAM用户没有权限调用该API。

   解决方法：请为该RAM用户授予相应OpenAPI权限。关于如何为RAM用户进行授权，请参见为RAM用户授权。

   例如，当您在调用SendSms时提示“You are not authorized to perform this operation”，您可以创建如下所示的自定义权限策略，并为该RAM用户授予相应的权限。

   {
     "Version": "1",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": "dysms:SendSms",
         "Resource": "*"
       }
     ]
   }

2. 调用OpenAPI时报错，提示 "SDKError：Message：Post "https://ecs-cn-XX.aliyuncs.com": dial tcp: lookup ecs-cn-XX.aliyuncs.com: no such host"。

   问题原因及解决方法

   问题原因：您所调用的OpenAPI不支持在初始化请求客户端时填写的Endpoint。

   解决方法：请查看Endpoint配置，修改Endpoint后重新调用OpenAPI。

3. 调用OpenAPI时报错，提示：“SDKError: StatusCode: 404 Code：InvalidAccessKeyId.NotFound Message: code: 404, Specified access key is not found. ”。

   问题原因及解决方法

   问题原因：您的AccessKey未正确传递。

   解决方法：在初始化请求客户端时，检查是否正确传递AccessKey。请注意os.Getenv("XXX")表示从环境变量中获取XXX的值。

更多SDK使用过程中的报错问题解决方案，请参见常见问题。