智能表格网页版中PY脚本编辑器API请求详情

快乐小子新
快乐小子新 Lv.2 潜力创作者

Lv.2潜力创作者

给AI装上一个Skill,让它一口气读懂你整个多维表格——连脚本和自动化流程都不放过李伟坚老师的SKILL中支持编写AirScript脚本,我们也可以继续为其增添Python脚本编写的功能,以下是我探测到的部分接口信息,可供参考。

为避免个人信息泄露,响应我就不放出来了,留给各位自行观察分析。

一、脚本生命周期管理(CRUD)—— 与 AirScript 同路径

所有脚本管理接口共用基础路径 /api/v3/ide/file/{file_id}/script,请求头需要 x-csrf-rand(浏览器登录态凭证)。

  1. 列出脚本
GET /api/v3/ide/file/{file_id}/script?ext=py

参数

位置

说明

file_id

path

智能表格文件 ID

ext

query

脚本扩展名筛选,PY 脚本传 py

ext=py 筛选 PY 脚本;不传或传 ext=js 返回 AirScript 脚本。

  1. 创建脚本
POST /api/v3/ide/file/{file_id}/script

请求体

{
  "script_name": "未命名脚本",
  "script": "",
  "ext": "py"
}
PY 通过 ext: "py" 标识语言;AirScript 则传 runtime_version: "1.0"ext 字段。

  1. 获取脚本详情
GET /api/v3/ide/file/{file_id}/script/{script_id}

  1. 更新脚本
PUT /api/v3/ide/file/{file_id}/script/{script_id}

支持三种更新模式:

更新代码

{ "change_script": true, "id": "V2-xxx", "script": "import pandas\r\n" }

重命名

{ "id": "V2-xxx", "script_name": "hexin" }

更新权限

{
  "change_permission_config": true,
  "id": "V2-xxx",
  "permission_config": { "http": { "open": true, "allow_all_host": false, "allow_hosts": null }, ... }
}

所有更新响应均为:{ "result": "ok" }


  1. 删除脚本
DELETE /api/v3/ide/file/{file_id}/script/{script_id}

二、PY 脚本执行体系(独立路径)

PY 脚本执行走独立 API 路径/pyaixscirpt/api/,与 AirScript 完全不同。

  1. 查询脚本状态
GET /pyaixscirpt/api/v2/{file_id}/script/{script_id}/state

  1. 获取日志地址
POST /pyaixscirpt/api/{file_id}/script/{script_id}/logs

  1. 执行脚本
POST /pyaixscirpt/api/v2/{file_id}/script/{script_id}/exec

请求体

{
  "sheet_name": "工作表1",
  "script": "import pandas\r\n",
  "contextInfo": "{\"canProtect\":true,\"envInfo\":{\"sheets\":[...]}}"
}

  1. 获取执行结果(SSE 流式)
GET /pyaixscirpt/api/v2/{file_id}/script/{script_id}/result?task_id={task_id}

请求头accept: text/event-stream

  1. 初始连接
POST https://shuc-js.ksord.com/bat/js/cors

请求体加密,用于建立 PY 脚本运行环境的初始会话。

  1. 监控日志上报
POST https://kmon.kdocs.cn/api/relay/store/{key}/log

请求体加密。

浏览 147
收藏
6
分享
6 +1
+1
全部评论