智能表格网页版中PY脚本编辑器API请求详情
快乐小子新
Lv.2潜力创作者
给AI装上一个Skill,让它一口气读懂你整个多维表格——连脚本和自动化流程都不放过李伟坚老师的SKILL中支持编写AirScript脚本,我们也可以继续为其增添Python脚本编写的功能,以下是我探测到的部分接口信息,可供参考。
为避免个人信息泄露,响应我就不放出来了,留给各位自行观察分析。
一、脚本生命周期管理(CRUD)—— 与 AirScript 同路径
所有脚本管理接口共用基础路径 /api/v3/ide/file/{file_id}/script,请求头需要 x-csrf-rand(浏览器登录态凭证)。
- 列出脚本
GET /api/v3/ide/file/{file_id}/script?ext=py参数 | 位置 | 说明 |
file_id | path | 智能表格文件 ID |
ext | query | 脚本扩展名筛选,PY 脚本传 py |
ext=py 筛选 PY 脚本;不传或传 ext=js 返回 AirScript 脚本。
- 创建脚本
POST /api/v3/ide/file/{file_id}/script请求体
{
"script_name": "未命名脚本",
"script": "",
"ext": "py"
}PY 通过 ext: "py" 标识语言;AirScript 则传 runtime_version: "1.0" 无 ext 字段。
- 获取脚本详情
GET /api/v3/ide/file/{file_id}/script/{script_id}- 更新脚本
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" }
- 删除脚本
DELETE /api/v3/ide/file/{file_id}/script/{script_id}二、PY 脚本执行体系(独立路径)
PY 脚本执行走独立 API 路径/pyaixscirpt/api/,与 AirScript 完全不同。
- 查询脚本状态
GET /pyaixscirpt/api/v2/{file_id}/script/{script_id}/state- 获取日志地址
POST /pyaixscirpt/api/{file_id}/script/{script_id}/logs- 执行脚本
POST /pyaixscirpt/api/v2/{file_id}/script/{script_id}/exec请求体
{
"sheet_name": "工作表1",
"script": "import pandas\r\n",
"contextInfo": "{\"canProtect\":true,\"envInfo\":{\"sheets\":[...]}}"
}- 获取执行结果(SSE 流式)
GET /pyaixscirpt/api/v2/{file_id}/script/{script_id}/result?task_id={task_id}请求头:accept: text/event-stream
- 初始连接
POST https://shuc-js.ksord.com/bat/js/cors请求体加密,用于建立 PY 脚本运行环境的初始会话。
- 监控日志上报
POST https://kmon.kdocs.cn/api/relay/store/{key}/log请求体加密。