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

Docs Map

文档目录

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

接入总览

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

上一页
更换字体
下一页
基础版接入(完整业务流)

接入形态

方式更适合谁你主要负责什么
基础版接入想快速嵌入完整创作台的客户完成 OAuth 授权、获取 SaaS URL、嵌入现成页面
组件版接入想保留自身前台流程,但需要独立编辑器能力的客户通过接口传数据,获取可独立打开的编辑器链接
用户体系与事件回调已进入正式运营期的客户做用户映射、消息通知、回调处理和运维协同

基础版接入

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

标准流程如下:

创建 SaaS 应用
-> OAuth 授权(PKCE)
-> 获取 access_token
-> 获取 SaaS URL
-> 嵌入你的门户 / 工作台 / 系统页面

适用场景如下:

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

组件版接入

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

典型流程如下:

自己的系统准备数据
-> 调用接口生成或换取独立编辑器链接
-> 在指定页面打开或跳转编辑器

适用场景如下:

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

用户体系与事件回调

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

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

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

建议阅读顺序

  1. 先看“用户授权(OAuth + PKCE)”
  2. 再根据交付方式判断是走“基础版接入”还是“组件版接入”
  3. 最后补“用户体系与事件回调”

注意事项

  1. 应用级 Token 和 OAuth access_token 不是一回事
  2. SaaS URL 通常是有时效和上下文约束的,不建议静态写死
  3. 如果客户要的是独立编辑器能力,不一定要嵌入完整 SaaS 页面