CSB 提供了 Java 版本的 HTTP API Client SDK 和 SOAP Web Service Client SDK。

获取 SDK

目前 CSB SDK 已经开源,发布地址为 https://github.com/aliyun/csb-sdk,您可以获取相关的代码并了解 SDK 的详细信息。

您还可以查看 CSB SDK 的版本信息

HTTP SDK

HTTP SDK 用来调用由 CSB 发布的 HTTP 服务,它主要用来向服务端发送 HTTP 请求,请求调用支持 POST/GET 方式。如果提供了 Access Key ID 和 Access Key Secret 参数信息,它能够在内部将请求消息进行签名处理,然后向 CSB 服务端发送进行验证和调用。

注意:

注意
  • 该版本的 SDK 要求的运行环境为 JDK 1.7 或 8 以上版本。
  • 该版本的 SDK 支持的 CSB 版本为 1.0.4.4 ~ 1.1.x.0。

HTTP SDK 的下载地址如下:

文档地址(不定期更新):HTTP SDK 使用说明

  • 介绍了 HTTP SDK 的使用方式,帮助 CSB OpenAPI 的使用者了解如何使用 SDK 进行命令行或者编程方式调用该 API。
  • 介绍了 HTTP SDK 的签名机制,帮助非 Java 语言的开发者了解 CSB-HTTP 请求的签名原理以便编写其它语言的 SDK 实现。
  • 提供了除 Java 版本的 SDK 之外,其它几种开发语言的 SDK 参考实现。

WebService SDK

WebService SDK 用来调用由 CSB 发布的 WebService 服务,它主要用来在每次调用时做方法拦截把安全需要的 KV 信息添加到 HTTP 请求头部分。

注意
  • 该版本的 SDK 要求的运行环境为 JDK 1.7 或 8 以上版本。
  • 该版本的 SDK 支持的 CSB 版本为 1.0.4.4 ~ 1.1.0.0。

WebService SDK 的下载地址如下:

文档的地址(不定期更新):WebService SDK 使用说明

  • 介绍了 WebService SDK 的使用方式,帮助 CSB OpenAPI 的使用者了解如何使用 SDK 进行命令行或者编程方式调用该 API。
  • 介绍了 WebService SDK 的签名机制,帮助非 Java 语言的开发者了解 CSB-WebService 请求的签名原理以便编写其它语言的 SDK 实现。

使用 SDK 示例

示例下载地址:sdk-sample.zip

  • 通过编程方式使用 HTTP SDK
  • 通过编程方式使用 WebService SDK

详情请参见 SDK 使用示例的说明

定制扩展能力

CSB SDK 支持以下定制扩展能力。

  • 自定义定制扩展能力。
  • 支持插件式定制实现自定义的验签逻辑、流量控制、预请求处理和响应处理。

详情请参见 CSB 用户自定义扩展说明

历史版本支持

如果您的 CSB 版本低于 1.1.0.0,还需要了解和使用旧版本的 SDK 及工具。