跳转到主要内容
1签 (OneSign)

SDK 与开发资源

本页内容

选择适合项目语言的服务端 SDK,按该语言指南完成初始化,再运行一个只读请求。需要自行实现客户端或生成工具时,可下载 OpenAPI 定义。

选择 SDK

已有服务端项目时,选择项目使用的语言。各源码包均附使用说明与 SHA256SUMS,当前为源码预览,并未表示已发布到公共包仓库。

浏览器 JavaScript、Vue、iOS 和安卓应用使用自己的后端或OAuth,不要内置服务端长期 Secret。

选择版本前,请查看SDK 版本与支持范围。完成只读调用后,可继续使用上传、等待与下载助手。

拿到源码包后先做什么

先按所选语言的入门页完成一次身份查询,再阅读需要的业务接口。源码包入口、SDK 库目录和业务项目可能是不同位置,构建命令应在教程指定的目录运行。

包内内容用来做什么何时查看
README.txt确认运行环境、文件布局、凭据变量和执行命令。解压后先读,按顺序完成第一次调用。
cloudsign-sdk/ 或 cloudsign/保存所选语言的客户端源码;不同语言的目录结构分别说明。集成自己的项目时保留相对位置。
示例与项目文件C 的完整示例包含根目录 CMake 工程;Rust 使用包内锁文件。其他语言按入门页保存示例。先核对当前目录,再运行对应命令,不在 SDK 库目录寻找另一个项目的示例目标。
SHA256SUMS核对源码包内文件完整性。首次使用与升级时核对,同时保存所用版本和包的独立摘要。

身份查询成功后核对账号、动作和应用范围。后续上传、签名、付款或发布分别判断业务结果,不能由“SDK 已安装”或“HTTP 返回成功”直接进入完成分支。概念区别见基本概念与接入路线。

配置并运行第一次调用

  1. 下载所选语言的源码包,在自己的项目或私有工作目录解压。
  2. 按该语言指南配置网站主域名和凭据,保留必要目录结构。
  3. 运行身份查询,核对账号与权限。
  4. 从具体接口页选择对应语言示例,替换为自己的真实资源 ID,再执行目标业务。

示例中的 CLOUDSIGN_BASE_URL 使用 https://www.onesignios.com。Python 标准库脚本和企业签名命令行工具使用不含协议的 CLOUDSIGN_HOST,各指南会注明。

下载接口定义与示例

需要自行实现客户端或使用 OpenAPI 工具时,可以下载接口定义。按产品导出会保留对应请求与响应,实际默认值、认证和权限仍以服务端规则为准。

选择调试环境

练习已支持的模拟操作,使用沙箱。验证自己真实资源的只读结果,可使用开发者中心调试。生产写入需单独授权并按业务流程确认。

C SDK 专题

下列入口供需要管理 C 对象生命周期或文件传输的开发者使用;初次接入先完成 C SDK 只读调用。