Coze插件：WebOS网页发布

文汇百川WebOS平台「网站库」支持接口调用，并提供专属 Coze 插件（在 Coze 插件市场搜索「WebOS网页发布」即可添加），支持将 HTML、Markdown、JSON、图片等多种格式内容一键发布为在线链接，方便在 Coze 工作流中生成可分享的网页内容。

Base URL：https://api.publicos.cn/api/web/coze

在 Coze 插件市场中搜索「WebOS网页发布」

打开 Coze 平台，进入插件市场，搜索关键词 WebOS网页发布 即可找到本插件。添加后即可在工作流中使用以下工具：

📄

html2url

将HTML代码发布为在线网页

📝

md2url

将Markdown文本发布为在线文档

📊

json2url

将JSON数据发布为在线文件

📁

file2url

将文件发布为在线文件（通用）

快速上手

使用 Coze 插件前，您需要先获取系统ID（osid）和网站库令牌（token）。以下是完整的操作流程：

1 打开账户中心，找到您的系统

首先打开 https://my.finalos.cn/，使用微信扫码登录。在账户中心的「仪表盘」页面中，可以看到个人名下的所有系统列表，双击或点击第一列即可打开对应系统。

2 进入系统桌面，找到【网站库】和【设置】

在系统中，点击左下角的【开始】按钮，可以展开开始菜单，其中包含【网站库】和【设置】两个关键入口：

网站库 — 文件保存的空间，每个网站库都有独立的令牌（token），用于 Coze 等平台调用 API
设置 — 可以查看系统ID、管理成员及其权限

3 查看网站库列表，获取 Token

点击【网站库】后，会显示所有已添加的网站库列表。系统默认初始化了两个网站库，您也可以自行添加新的网站库。

每个网站库都有一个专属的 token（令牌），这就是调用 Coze 插件接口时需要传入的关键参数。点击表格中对应的链接即可复制该网站的令牌。

4 设置网站库/文件的公开访问权限

每个网站库都可以设置是否对外公开：

外部公开 = 支持：公网用户无需登录即可访问
外部公开 = 禁止：只有系统成员可以访问

右键点击网站库或者右键点击具体文件，均可看到【新窗口打开】【公网地址访问】等菜单选项。如果需要通过公网地址访问文件，请确保已开启「外部公开」权限。

完成以上步骤后，您就获得了：
• 系统ID（osid） — 在账户中心或系统设置中可查
• 网站库令牌（token） — 在网站库列表中获取
接下来就可以在 Coze 工作流中配置插件并调用接口了！

5 在 Coze 中调用插件发布文件（效果预览）

在 Coze 工作流中使用本插件调用接口后，文件会自动上传到对应的网站库中。下图展示了通过 Coze 插件测试时上传的各种格式文件（HTML、JSON、MD、PNG 等），所有文件均可在网站库中查看和管理。

通用说明

所有接口均为 POST 请求，Content-Type 为 application/json，需要携带 Query 参数 osid（系统ID，示例：S12345，注意是S开头）。

重要：每个接口必须传入 token 参数。每个网站库拥有独立的令牌（token），请妥善保管。

html2url - 将HTML代码发布为在线网页

POST /html2url?osid=S12345 发布HTML为在线网页

将HTML代码内容发布为在线网页，生成可直接访问的URL链接。

请求参数（Body）

参数名	类型	必填	说明
`token`	string	必填	令牌，每个网站库有自己独立的令牌
`html`	string	必填	HTML代码内容
`filename`	string	可选	文件名，如果不写则生成随机名称
`path`	string	可选	文件路径，不写默认为根目录，示例：`/china/beijing`

Query 参数

参数名	类型	必填	说明
`osid`	string	必填	系统ID，示例：`S12345`

请求示例

JSON { "token": "your_token_here", "html": "<h1>Hello World</h1><p>我的第一个网页</p>", "filename": "hello.html", "path": "/demo" }

响应示例（成功）

JSON { "code": 0, "msg": "success", "url": "https://xxx.publicos.cn/xxx/hello.html" }

md2url - 将Markdown文本发布为在线文档

POST /md2url?osid=S12345 发布Markdown为在线文档

将Markdown文本内容发布为在线文档，生成可直接访问的URL链接。

请求参数（Body）

参数名	类型	必填	说明
`token`	string	必填	令牌，每个网站库有自己独立的令牌
`md`	string	必填	Markdown代码内容
`filename`	string	可选	文件名，如果不写则生成随机名称
`path`	string	可选	文件路径，不写默认为根目录，示例：`/china/beijing`

Query 参数

参数名	类型	必填	说明
`osid`	string	必填	系统ID，示例：`S12345`

请求示例

JSON { "token": "your_token_here", "md": "# 标题\n\n这是一段Markdown内容\n\n- 列表项1\n- 列表项2", "filename": "readme.md", "path": "/docs" }

响应示例（成功）

JSON { "code": 0, "msg": "success", "url": "https://xxx.publicos.cn/xxx/readme.md" }

json2url - 将JSON发布为在线文件

POST /json2url?osid=S12345 发布JSON为在线文件

将JSON内容发布为在线文件，生成可直接访问的URL链接。

请求参数（Body）

参数名	类型	必填	说明
`token`	string	必填	令牌，每个网站库有自己独立的令牌
`json`	string	必填	JSON内容
`filename`	string	可选	文件名，如果不写则生成随机名称
`path`	string	可选	文件路径，不写默认为根目录，示例：`/china/beijing`

Query 参数

参数名	类型	必填	说明
`osid`	string	必填	系统ID，示例：`S12345`

请求示例

JSON { "token": "your_token_here", "json": "{\"name\": \"张三\", \"age\": 25, \"city\": \"北京\"}", "filename": "data.json", "path": "/api" }

响应示例（成功）

JSON { "code": 0, "msg": "success", "url": "https://xxx.publicos.cn/xxx/data.json" }

file2url - 将文件发布为在线文件

POST /file2url?osid=S12345 发布文件为在线文件（通用）

通用文件发布接口，支持 jpg、png、gif、webp、html、json、xml、txt、md 等格式的文件发布为在线文件。

提示：不同 OS 版本限制的文件大小不同，请注意文件大小上限。

请求参数（Body）

参数名	类型	必填	说明
`token`	string	必填	令牌，每个网站库有自己独立的令牌
`file`	string (file_url)	必填	文件的url（coze中会把文件转为可以访问的url），支持 jpg、png、gif、webp、html、json、xml、txt、md 格式
`filename`	string	可选	文件名，如果不写则生成随机名称
`path`	string	可选	文件路径，不写默认为根目录，示例：`/china/beijing`

Query 参数

参数名	类型	必填	说明
`osid`	string	必填	系统ID，示例：`S12345`

请求示例

JSON { "token": "your_token_here", "file": "https://example.com/image.png", "filename": "my-image.png", "path": "/images" }

响应示例（成功）

JSON { "code": 0, "msg": "success", "url": "https://xxx.publicos.cn/xxx/my-image.png" }

支持的文件格式

类型	扩展名	说明
图片	jpg, png, gif, webp	支持常见图片格式
网页	html	HTML网页文件
数据	json, xml	结构化数据文件
文本	txt	纯文本文件
文档	md	Markdown文档

响应说明

所有接口统一使用以下响应格式：

字段名	类型	说明
`code`	integer	状态码，`0` 表示成功，其他数字表示失败
`msg`	string	相应的提示消息
`url`	string	成功时返回在线文件的URL地址

响应示例（失败）

JSON { "code": 1001, "msg": "token无效" }

注意事项

Token 安全：请妥善保管您的 token，不要在公开场合泄露。每个网站库拥有独立的令牌。

文件大小限制：不同 OS 版本对文件大小有不同限制，请根据您的版本选择合适的文件大小进行上传。

文件名规则：如果不填写 filename，系统会自动生成一个随机文件名。

路径规则：path 参数用于指定发布后的文件存放路径，不填写则默认存放在根目录下。