概述

集成场景

集成方应用在工具栏或推广入口处嵌入两个功能入口：

• 发起签署 — 集成方应用完成 OAuth 授权后，调用 上传文件 拿到 FileId，再调用 获取内嵌页 URL 把 FileId 绑定到内嵌页 URL，最后用 WebView 打开内嵌页完成创建签署流程（设置接收人 → 放置签名区域 → 发送）
• 签署状态 — 换取内嵌页 URL，WebView 直接显示当前账号在选定 Space 下的合同列表

内嵌页面由 Tencent eSign 提供，支持集成方品牌定制（详见 内嵌页交互 - 品牌定制），通过 webview token 与 Tencent eSign 服务端交互。

接入模式

OAuth 授权模式

本指南支持两种授权模式，适用于不同集成场景：

• 开放模式（默认） — 面向 C 端用户，每个邮箱可独立发起授权，Space 由用户在 Consent 页自行选择或系统自动创建，授权 URL 无需传 space_id
• 指定 Space 模式 — 面向企业/组织场景，授权对象限定在集成方预先指定的 Space，需配合 预添加成员 接口预添加成员，授权 URL 同时传入 space_id + login_hint，详见 OAuth 授权流程 - 指定 Space 模式

核心概念

关键约束

1. 集成方走**第三方应用模式（third_party app）**接入
2. 集成方先在 Tencent eSign 控制台自助注册账户（创建集成方 Space），由该 Space 管理员在控制台创建 OAuth App，控制台直接生成 client_id / client_secret。多地域场景下集成方需在每个地域分别注册并各自创建 App，凭证按地域隔离不通用（计费资源包同样按地域闭环）
3. 用户首次接入（双模式）：
   • 开放模式 — 集成方可在打开授权页时传入 login_hint（用户邮箱）供授权页预填；若该邮箱尚未在 Tencent eSign 注册，系统自动静默完成注册并创建默认 Space（该用户为管理员）。不需传 space_id，由用户在授权页自行选择 Space
   • 指定 Space 模式 — 集成方同时传入 space_id + login_hint，系统不自动创建 Space；用户必须已通过 预添加成员 接口被预添加为该 Space 的待激活成员，授权时点「同意」即视为接受邀请并完成激活。详见 OAuth 授权流程 - 指定 Space 模式
4. 应用自动安装 — 用户在 Consent 页完成授权时，若当前 Space 尚未安装该集成应用且用户是管理员，Tencent eSign 自动完成安装，对用户无感
5. 文件由集成方应用调用 上传文件 接口拿到 FileId 后，通过 获取内嵌页 URL 接口的 OperateParam.FileIds 绑定到 webview token，内嵌页加载即可使用

职责分工

集成方负责

Tencent eSign 负责

涉及接口