类型 | 支持版本 |
REST API | 全版本（HTTP / HTTPS） |
能力 | 支持情况 | 说明 |
离线同步（读 / 写） | ✓ / - | 支持作为离线同步任务的源端读取数据；DataBuddy 数据源仅支持接入读取，不支持写入 |
限制项 | 说明 |
响应格式 | 需返回 JSON 格式数据 |
认证方式 | 支持无认证 / Basic / Token / OAuth2 密码模式 / OAuth2 客户端模式 |
认证方式 | 说明 |
无认证 | 接口无需认证 |
Basic | 用户名 + 密码 |
Token | 固定令牌 |
OAuth2 密码模式 | 用户名 + 密码换取令牌 |
OAuth2 客户端模式 | ClientId + ClientSecret 换取令牌 |
参数 | 说明 | 是否必填 | 默认值 |
数据源名称 | 数据源在工作空间内的唯一标识 | 是 | — |
请求地址 | 接口完整 URL | 是 | — |
认证方式 | 无认证 / Basic / Token / OAuth2 密码模式 / OAuth2 客户端模式 | 是 | 无认证 |
用户名 / 密码 | Basic 或 OAuth2 密码模式下的账号 | 相应认证方式必填 | — |
Token | Token 认证下的固定令牌 | 认证方式为 Token 时必填 | — |
ClientId / ClientSecret | OAuth2 客户端模式下的凭证 | 认证方式为 OAuth2 客户端模式时必填 | — |
Token 端点 / Scope | OAuth2 模式下的令牌端点与作用域 | OAuth2 认证时必填 | — |
配置项 | 说明 |
源连接 | 已配置的 REST API 数据源，必填；可点击 测试 验证连通性 |
读取方式 | 解析数据：解析接口返回的 JSON 内容，按字段映射写入目标表 原始文件：不解析响应内容，将接口返回的原始数据整体写入目标端。常规结构化接入选择解析数据 |
请求方式 | 接口的 HTTP 方法，POST / GET |
返回数据类型 | 接口响应的数据格式，当前支持 JSON |
JSON 数据路径 | 以 JSONPath 定位响应中记录所在的层级，例如 $.data.list；需指向记录数组或单条记录对象。配置后，字段映射中的来源字段 JSONPath 以单条记录为根节点 |
返回数据结构 | 单条数据：响应为单个 JSON 对象； 数组：响应为 JSON 对象数组，每个元素为一条记录。注意数组模式下每条记录必须是 JSON 对象，二维数组会导致解析失败 |
请求头 | 接口请求头，按界面提示填写，如 {"Accept-Language":"zh-cn"}；需携带认证信息时（如 Authorization）也在此填写 |
请求参数 | 选填。GET 方式填写拼接在 URL 后的查询参数，如 name=wedata&age=10；POST 方式填写请求体参数 |
高级设置 | 单击设置，配置高级参数，默认即可满足一般场景；数据量较大时建议按接口的查询参数拆分为多个任务分别读取 |
实践 | 建议 |
认证安全 | 优先使用 OAuth2，避免明文密码 |
分页处理 | 确认接口分页机制，避免数据遗漏 |
限流控制 | 合理设置请求频率，避免触发接口限流 |
文档反馈