Skip to content

Home

Jump to bottom
FeiYin edited this page Jan 3, 2024 · 2 revisions

易盾GOLANG SDK是什么？

易盾GOLANG SDK是易盾 API 的配套工具。目的是为了简化 GOLANG 开发者调试和接入易盾 API 的成本，提供更快捷和更方便的接入方式，并打包一系列开发者在接入过程中可能存在的痛点功能，包括同步重试、熔断降级、就近访问、回调获取等。

易盾GOLANG SDK具有哪些功能特性？

具有以下功能特性：

  • 完善的失败处理：

    • 接口请求提供同步重试机制，在出现调用失败时，会自动重试指定region内的下一个请求节点。

    • 接口请求支持熔断降级，在当前时间窗口内，指定region的某个节点失败请求次数到达阈值时，会触发熔断，后续请求会自动路由到region内的其他可用节点，直到超过熔断时间再对熔断节点探活。

  • 丰富的签名算法：

    • 内置多种接口签名算法支持，包括MD5、SHA1、SHA256、SM3

  • 灵活的接口配置：

    • 常用的http请求的各项配置，包括接口超时参数，http连接池连接数、空闲时间等核心参数。

    • 切换请求协议，通过在请求对象中设置protocol字段，切换HTTP/HTTPS协议，默认HTTPS。

    • 指定region（默认杭州），根据您服务器的所在地，选择适合的region，以达到更好的请求效果，支持的region列表请咨询您的商务经理。

    • 熔断窗口的各项配置，包括窗口大小、熔断时间、错误率阈值、熔断生效的请求数阈值。

详细的配置支持：

  • http请求各项参数配置

     // 按照需求设置http请求的多个参数配置
 credential := auth.NewCredentials("accessKeyId", "accessKeySecret")
 clientProfile := client.NewClientProfile(credential)
 clientProfile.HttpClientConfig.ConnectionKeepAliveMillis = 10000
 crawlerSubmitClient := crawler.NewCrawlerClient(clientProfile)

  • 请求协议

    // 覆盖默认请求协议
request := submit.NewCrawlerResourceV3SubmitRequest()
request.SetProtocol(http.ProtocolEnumHTTPS)

  • 熔断配置

    credential := auth.NewCredentials("accessKeyId", "accessKeySecret")
clientProfile := client.NewClientProfile(credential)
// 按照需求设置固定窗口的多个熔断参数配置
clientProfile.BreakerConfig.SetStatWindowMillis(10000)
crawlerSubmitClient := crawler.NewCrawlerClient(clientProfile)

  • 重试配置

    credential := auth.NewCredentials("accessKeyId", "accessKeySecret")
clientProfile := client.NewClientProfile(credential)
// 最大10次
clientProfile.SetMaxRetryCount(10)
crawlerSubmitClient := crawler.NewCrawlerClient(clientProfile)
Clone this wiki locally