韦尼克产品文档

Appearance

📑SaaS 功能扩展API文档 ​

本指南介绍在获取 access_token 后，如何调用 SaaS 功能扩展 API，例如：

  • 上传 JSON 文件并生成编辑器地址
  • 通过 Markdown 生成编辑器地址
  • 查询用户 PPT 生成记录

📌 前置条件：

请先完成🧩 Saas授权接入指南 | 韦尼克产品文档，通过授权码（code）获取access_token。

所有接口都需要在Header中携带：

css
Authorization: Bearer {{access_token}}

功能一：上传 JSON 文件 → 获取编辑器地址 ​

接口地址：

ruby
POST https://saas.api.yoo-ai.com/saas/api/editor-ppt

请求参数：

  • Header

​ Authorization: Bearer

​ Content-Type: application/json

  • Body
字段类型必填说明
json_urlStringYjson文件URL
ref_urlStringY返回设置URL。
cover_idStringN封面模板ID

响应参数：

字段类型说明
saas_pptStringSaaS访问url地址。（单次使用生效，重新使用需使用ppt_id再次请求）
ppt_idstring该份PPT的标识

响应示例：

json
{
    "code": 200,
    "msg": "success",
    "data": {
        "saas_ppt": "https://ppt.yoo-ai.com/editor?code=f8Cutded3b",
        "ppt_id": "r6hfbHj9Dy",
        "cover_id": "teCgNSsX"
    },
    "request_id": "YOO-saas68f5a15a48038"
}

获取模板 ​

接口地址：

ruby
GET https://saas.api.yoo-ai.com/apps/ppt-cover-static

请求参数：

  • Header

该接口使用是在创建saas应用后，配置信息中获取的Token

​ Authorization: Bearer

​ Content-Type: application/json

  • Query
字段类型必填说明
stylestringN风格类型：极简风、科技风、小清新、商务风、党政风、可爱卡通、中国风
color_stylestringN颜色：粉色、黄色、青色、蓝色、绿色、橙色、紫色
languagestringN语言：中文、英文
limitstringN获取条数[1,20],默认1

响应参数：

字段类型说明
styleString风格类型
color_styleString颜色类型
languageString语言类型
idString模板ID
cover_imageString固定资源：封面图片

响应示例：

json
{
    "code": 200,
    "msg": "success",
    "data": [
        {
            "style": "极简风",
            "color_style": "蓝色",
            "language": "中文",
            "special": "",
            "id": "teCgNSsX",
            "cover_image": "https://image.yoojober.com/motion-online/template/full/photo/1761613101455.jpg"
        }
    ],
    "request_id": "YOO-saas-api69364ee61ecdf"
}

根据PPT_ID获取下载链接 ​

由于 PPT 的渲染过程完全在前端完成，因此在首次获取下载链接前，必须先打开对应的编辑器链接，等待 PPT 在前端渲染完毕并将结果上报至后端。只有在首次渲染上报成功后，系统才能生成并提供可下载的 PPT 文件链接。

计费说明：在 1 小时内，无论是从编辑器中下载，还是通过接口获取下载链接，均只收取一次费用。

接口地址：

ruby
POST https://saas.api.yoo-ai.com/saas/api/ppt-download

请求参数：

  • Header

​ Authorization: Bearer

​ Content-Type: application/json

  • Body
字段类型必填说明
ppt_idstringYppt标识

响应参数：

字段类型说明
download_urlString下载链接

响应示例：

json
{
    "code": 200,
    "msg": "success",
    "data": {
        "download_url": "https://file.static.yoojober.cn/chatppt/20251208/3z0cqj3gq1miy.pptx"
    },
    "request_id": "YOO-saas693678c63a3c0"
}

获取历史PPT在线编辑链接 ​

通过ppt_id可以重新获取编辑链接。该链接将加载PPT的内容，且内容为最后一次手动保存时的版本。

接口地址：

ruby
POST https://saas.api.yoo-ai.com/saas/api/editor-ppt

请求参数：

  • Header

​ Authorization: Bearer

​ Content-Type: application/json

  • Body
字段类型必填说明
ppt_idstringYppt标识

响应参数：

字段类型说明
saas_pptStringSaaS访问url地址。（单次使用生效，重新使用需使用ppt_id再次请求）
ppt_idstring该份PPT的标识

响应示例：

json
{
    "code": 200,
    "msg": "success",
    "data": {
        "saas_ppt": "https://ppt-test.yoo-ai.com/editor?code=33PbBZKarp",
        "ppt_id": "r6hfbHj9Dy"
    },
    "request_id": "YOO-saas68f743a2078e2"
}

功能二：Markdown → 获取编辑器地址 ​

接口地址：

ruby
POST https://saas.api.yoo-ai.com/saas/api/md-ppt

请求参数：

  • Header

​ Authorization: Bearer

​ Content-Type: application/json

  • **Body **
字段类型必填说明
textstringYMarkdown数据

响应参数：

字段类型说明
saas_pptStringSaaS访问url地址。（单次使用生效，重新使用需再次请求）

响应示例：

json
{
    "code": 200,
    "msg": "success",
    "data": {
        "saas_ppt": "https://index.ppt.yoo-ai.com?code=Qv2CY6s3Tm"
    },
    "request_id": ""
}

功能三：查询 PPT 生成记录 ​

接口地址：

ruby
POST https://saas.api.yoo-ai.com/saas/api/history

请求参数：

  • Header

​ Authorization: Bearer

​ Content-Type: application/json

  • Body
字段类型必填说明
pageNumberY页数
page_sizeNumberY每页返回数

请求示例：

json
{
    "page":5,
    "page_size":10
}

响应参数：

字段类型说明
ppt_listArrayPPT生成记录列表，包含每个记录的详细信息。
current_pageNumber当前页数
totalNumber总条数
last_pageNumber最后一页数

响应示例：

json
{
  "code": 200,
  "msg": "success",
  "data": {
    "ppt_list": [
      {
        "title": "海滨儿童游乐区设计",
        "created_at": "2025-07-04 15:59:18",
        "app_id": "",
        "uid": ""
      },
      {
        "title": "海滨亲子乐园设计",
        "created_at": "2025-07-03 19:03:57",
        "app_id": "",
        "uid": ""
      }
    ],
    "current_page": 1,
    "total": 197,
    "last_page": 20
  },
  "request_id": "YOO-saas68a7dba6015e5"
}

📌 常见问题（FAQ） ​

Q1：为什么生成的编辑器地址是一次性的？

出于安全考虑，生成的 saas_ppt 有效期较短，需重新获取。

Q2：支持哪些输入方式？

目前支持 JSON 文件 和 Markdown 文本 两种方式生成 PPT 编辑器。

Q3：是否支持在线重新编辑？

支持在线重新编辑。只需记录每份PPT的 ppt_id，通过该ID可以重新获取编辑链接。该链接将加载PPT的内容，且内容为最后一次手动保存时的版本。

📎 相关文档 ​