数据 API:让外部系统读你的表

它解决什么

导出文件是一次性的快照。数据 API 把表变成一个接口:外部程序随时 GET 一下,拿到的就是此刻的数据,包括刚算好的公式列。适合:

• 自己写的脚本定时取数
• 别的系统(ERP、小程序后台)读超级表里维护的主数据
• 报表工具直接连

它在付费版的能力清单里,叫「API 出」。

怎么开

1. 打开表,工具栏「导出 → 数据API」,弹出标题为「API」的窗口。
2. 两个标签:字段列出这张表每一列的 id、列号(AA1、AA2……)、列名、公式和类型;请求给出可以直接粘走的 curl 命令和一段返回示例,右上角 JSON / CSV 切换返回格式。
3. 右上角 API-Key 按钮控制示例里要不要带上密钥(密钥是工作空间级的,团队版里项目也可以有自己的 API-Key,同工作空间的表共用)。复制这条命令到外部系统里跑,密钥放在 apiKey 请求头。

替换密钥

密钥泄露或人员变动时,面板里点「替换密钥」。确认框问「旧API将无法访问,是否替换?」——确认后所有用旧密钥的调用立刻失败,更新到新密钥即可。地址不变。

读到的是什么

• 表的全部行和列,含公式列的当前值。形状是 {"code":"success","data":[{"id":"37","entry":{...}}]},一行一个 entry。
• entry 里的键是列 id(59048da8 这样的十六进制串),不是列名;序号列固定是 _index,另外还有 submit_at / submit_by 两个提交元信息字段。
• 列 id ↔ 列名的对照在弹窗的字段标签里。改列名不影响 id,所以外部系统按 id 取值最稳;别按位置取。

桌面版的边界

桌面版的引擎只在你的电脑上,接口地址也只在本机(或同一台电脑上的程序)能访问,外网访问不到。要给公司里其他系统读,用团队版,它的接口地址是云端的。

反过来:让外部系统写进来

那是数据同步里「作为服务端」的 HTTP 连接,或者自动化。数据 API 只读。