集成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时出现超时等问题。

   import (
     "os"
   
     openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
     facebody20191230 "github.com/alibabacloud-go/facebody-20191230/v5/client"
     "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")),
     }
     // 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. 创建AdvanceRequest结构体实例

   在上传本地文件时，需要通过SDK提供的AdvanceRequest结构体来传递文件流。AdvanceRequest结构体命名格式为<OpenAPI名称>AdvanceRequest，关于传递文件流的参数名，请在相应的AdvanceRequest结构体中查找参数类型为io.Reader的参数。

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

3. 发起请求

   调用函数<接口名称>Advance发起请求，入参为指向AdvanceRequest结构体的指针。

   //  需要在import中添加  util "github.com/alibabacloud-go/tea-utils/v2/service"
   
   func _main() (response *facebody20191230.DetectBodyCountResponse, _err error) {
     client, _err := CreateClient()
     if _err != nil {
       return nil, _err
     }
   
     // 需替换文件路径
     filePath := `<FILE_PATH>`
     // 打开文件并创建流
     file, err := os.Open(filePath)
     if err != nil {
       return nil, fmt.Errorf("打开文件失败: %v", err)
     }
     defer file.Close() // 关闭文件
     // 创建请求对象
     detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
       ImageURLObject: file,
     }
     runtime := &util.RuntimeOptions{}
     // 发起请求
     response, _err = client.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime)
   
     if _err != nil {
       return nil, _err
     }
     return response, nil
   }

package main

import (
  "fmt"
  "os"

  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() (response *facebody20191230.DetectBodyCountResponse, _err error) {
  client, _err := CreateClient()
  if _err != nil {
    return nil, _err
  }

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

  if _err != nil {
    return nil, _err
  }
  return response, nil
}
func main() {
  response, err := _main()
  if err != nil {
    panic(err)
  }
  fmt.Println(response)
}

常见问题

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使用过程中的报错问题解决方案，请参见常见问题。