韦尼克产品文档

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。

响应参数：

字段类型说明
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"
    },
    "request_id": "YOO-saas68f5a15a48038"
}

获取历史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的内容，且内容为最后一次手动保存时的版本。

📎 相关文档 ​