韦尼克产品文档

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_urlStringY授权码，即终端用户授权后，页面重定向的 URL 中 code 参数的值。
ref_urlStringY返回设置URL。

响应参数：

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

响应示例：

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

✍️ 二、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 编辑器。

📎 相关文档 ​