韦尼克 Logo
韦尼克平台
AI Document Platform
⌘K
开发文档API 调试台AI接入助手

Docs Map

文档目录

产品介绍选择接入方式先读企业认证 & Token 获取方式共用
接入总览先看基础版接入(完整业务流程)组件版接入(返回编辑器链接)
收费标准
首页接入总览

SaaS 嵌入接入总览

说明 SaaS 嵌入方案的适用场景、接入形态,以及授权、用户体系和回调关系。

上一页
添加PPT演讲稿
下一页
基础版接入(完整业务流程)

SaaS 嵌入方案建议按 两种接入方法 来理解:

  • 基础版接入:接入完整 SaaS 创作台页面
  • 组件版接入:通过接口换取独立编辑器链接或查询历史记录

两种方法在前置步骤上是相同的,都必须先完成 OAuth + PKCE 授权,获取 access_token。区别只在于拿到 access_token 之后,后续调用的接口不同。

接入方法对比

方法更适合谁获取 access_token 后做什么
基础版接入想快速嵌入完整创作台的客户调用 /oauth/saas-url 获取完整 SaaS 页面地址
组件版接入想保留自身前台流程,但需要独立编辑器能力的客户调用功能扩展接口,获取编辑器链接或查询历史记录

共同前置步骤

无论选择哪一种接入方法,前面的授权流程都一致:

注册并完成平台准备
-> 创建 SaaS 应用
-> 配置安全域名
-> OAuth 授权(PKCE)
-> 获取 access_token

如果你还没有拿到 access_token,建议先阅读 基础版接入(完整业务流程) 的前半部分,那里已经把授权所需的核心接口串起来了。

方法一:基础版接入

基础版接入用于嵌入完整业务流页面,适合以较低改造成本快速完成产品集成。

标准流程如下:

完成公共授权流程
-> 获取 access_token
-> 调用 /oauth/saas-url
-> 获取 saas_ppt
-> 嵌入你的门户 / 工作台 / 系统页面

适用场景如下:

  • 希望尽快上线,不想自己重做创作台
  • 需要相对完整的一站式用户体验
  • 更关注交付速度,而不是页面深度自定义

对应文档: 基础版接入(完整业务流程)

方法二:组件版接入

组件版接入适用于已有业务流程、仅需在特定环节接入编辑器或独立能力页面的场景。

典型流程如下:

完成公共授权流程
-> 获取 access_token
-> 调用组件版接口生成编辑器地址
-> 在指定页面打开或跳转编辑器

适用场景如下:

  • 已有门户、表单流或工作流系统
  • 不想整页嵌入完整 SaaS 创作台
  • 希望把编辑器作为单独步骤嵌入业务链路

对应文档: 组件版接入(返回编辑器链接)

用户体系与事件回调

在正式上线和持续运营阶段,通常还需要补充以下能力:

  • SaaS 子用户如何创建、映射、禁用
  • 事件通知、业务回调如何接收和处理

该部分不一定属于首期联调范围,但通常是正式上线前必须确认的内容。

建议阅读顺序

  1. 先看“接入总览”,判断自己属于基础版还是组件版
  2. 如果要接入完整创作台,继续看 基础版接入(完整业务流程)
  3. 如果要接入独立编辑器能力,继续看 组件版接入(返回编辑器链接)
  4. 正式上线前,再补看“用户体系与事件回调”

注意事项

  1. 应用级 Token 和 OAuth access_token 不是一回事
  2. access_token 是基础版接入和组件版接入的共同前置条件
  3. SaaS URL 和编辑器链接通常都带有时效性,不建议静态写死