SDK 与开发资源
本页内容
选择适合项目语言的服务端 SDK,按该语言指南完成初始化,再运行一个只读请求。需要自行实现客户端或生成工具时,可下载 OpenAPI 定义。
选择 SDK
已有服务端项目时,选择项目使用的语言。各源码包均附使用说明与 SHA256SUMS,当前为源码预览,并未表示已发布到公共包仓库。
Python3.10+查看接入步骤 →PHP8.3+,启用 ext-curl查看接入步骤 →Node.js / TypeScriptNode.js 20+查看接入步骤 →Go1.22+查看接入步骤 →JavaJDK 17+查看接入步骤 →Rust1.88+,使用 Tokio查看接入步骤 →CC11、CMake 3.20+,需原生依赖查看接入步骤 →
浏览器 JavaScript、Vue、iOS 和安卓应用使用自己的后端或OAuth,不要内置服务端长期 Secret。
选择版本前,请查看SDK 版本与支持范围。完成只读调用后,可继续使用上传、等待与下载助手。
拿到源码包后先做什么
先按所选语言的入门页完成一次身份查询,再阅读需要的业务接口。源码包入口、SDK 库目录和业务项目可能是不同位置,构建命令应在教程指定的目录运行。
| 包内内容 | 用来做什么 | 何时查看 |
|---|---|---|
README.txt | 确认运行环境、文件布局、凭据变量和执行命令。 | 解压后先读,按顺序完成第一次调用。 |
cloudsign-sdk/ 或 cloudsign/ | 保存所选语言的客户端源码;不同语言的目录结构分别说明。 | 集成自己的项目时保留相对位置。 |
| 示例与项目文件 | C 的完整示例包含根目录 CMake 工程;Rust 使用包内锁文件。其他语言按入门页保存示例。 | 先核对当前目录,再运行对应命令,不在 SDK 库目录寻找另一个项目的示例目标。 |
SHA256SUMS | 核对源码包内文件完整性。 | 首次使用与升级时核对,同时保存所用版本和包的独立摘要。 |
身份查询成功后核对账号、动作和应用范围。后续上传、签名、付款或发布分别判断业务结果,不能由“SDK 已安装”或“HTTP 返回成功”直接进入完成分支。概念区别见基本概念与接入路线。
配置并运行第一次调用
- 下载所选语言的源码包,在自己的项目或私有工作目录解压。
- 按该语言指南配置网站主域名和凭据,保留必要目录结构。
- 运行身份查询,核对账号与权限。
- 从具体接口页选择对应语言示例,替换为自己的真实资源 ID,再执行目标业务。
示例中的 CLOUDSIGN_BASE_URL 使用 https://www.onesignios.com。Python 标准库脚本和企业签名命令行工具使用不含协议的 CLOUDSIGN_HOST,各指南会注明。
下载接口定义与示例
需要自行实现客户端或使用 OpenAPI 工具时,可以下载接口定义。按产品导出会保留对应请求与响应,实际默认值、认证和权限仍以服务端规则为准。
选择调试环境
练习已支持的模拟操作,使用沙箱。验证自己真实资源的只读结果,可使用开发者中心调试。生产写入需单独授权并按业务流程确认。
C SDK 专题
下列入口供需要管理 C 对象生命周期或文件传输的开发者使用;初次接入先完成 C SDK 只读调用。