连接 HTTP 接口
让超级表定时去拉一个接口(客户端模式),或者让外部系统往超级表推数据(服务端模式)。粘贴 URL 智能解析、加 Headers 认证、用 JSONPath 只取需要的字段。
两种方向
「数据同步 → 新建同步 → HTTP」之后先选方向:
| 模式 | 谁发起 | 适合 |
|---|---|---|
| 作为客户端 | 超级表按计划去请求你给的 URL | 第三方开放 API、你自己系统的查询接口 |
| 作为服务端 | 超级表给你一个地址,外部系统往这个地址 POST 数据 | 设备、脚本、别的系统主动推送 |
HTTPS 和 HTTP 都支持。
客户端模式
连接配置:把接口地址粘进「粘贴 url 自动解析 host」,系统拆出主机和路径。需要 Token 的接口,在 Headers 里加一行 Key / Value(比如 Authorization: Bearer …)。不同系统的认证方式不一样,以接口文档为准。
通道配置:填备注、请求间隔;「调试一下」能立刻发一次请求,看返回的原始内容。这一步没拿到返回就别往下走。
定义数据结构:返回的 JSON 显示在预览里,勾选要进表的节点。接口通常返回一个包着数组的对象,用「源代码」模式写一条 JSONPath 直接定位到数组,例如:
$.data.list[*]常用写法:$..name 取任意层级的 name;$.items[?(@.status == 'paid')] 按条件过滤;$.items[0:10] 只取前 10 条。JSONPath 的完整语法见函数参考里的 JSONPath 一节。
绑定数据列:字段对列,完成。
服务端模式
选「作为服务端」后,超级表生成一个接收地址。把它配置到外部系统的推送目标里,外部系统每 POST 一次,表里多一行(或按序号列更新一行)。「通道配置」里可以发一条调试数据,确认格式后再定义结构、绑定列。