必须通过Zion标准API同步数据,先在开发设置中启用API服务,再获取Secret Key或OAuth token,最后用Table ID调用/tables/{table_id}/records接口传Authorization和参数过滤。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要把函子Zion里的数据同步到外部系统(比如ERP、CRM、BI工具或自建后台),必须通过标准API通道完成,不能直接导出数据库文件或绕过权限访问原始表结构。
确认项目已开启API服务
进入Zion项目控制台 → 左侧导航栏点击【开发设置】→ 在「API服务」模块中,将开关切换为「启用」。这一步是所有后续操作的前提,【未开启时任何外部请求都会返回403错误】。
启用后系统会自动生成一个全局API Base URL,形如 https://api.zion.fun/v1/your-project-id,这个地址将用于所有接口调用。
获取合法访问凭证
方法一:使用项目级API密钥(适合服务端直连)
在【开发设置】→【API密钥管理】中点击「新建密钥」→ 填写描述(如“对接金蝶ERP”)→ 点击创建 → 复制生成的 【Secret Key】 并立即保存——该密钥只显示一次,丢失需重新生成。
方法二:使用OAuth 2.0用户令牌(适合前端嵌入或需要用户授权的场景)
调用 /auth/authorize 发起授权跳转,用户登录Zion账号并同意权限后,回调地址会收到临时code,再用code向 /auth/token 换取access_token。注意:此token有效期默认2小时,需自行实现刷新逻辑。
调用具体数据接口
第一步:查清目标数据表的内部标识符
进入Zion数据管理页 → 找到要对接的那张表 → 点击右上角「更多」→ 「查看API文档」→ 复制顶部显示的 【Table ID】,例如 tbl_abc123xyz。这个ID不是表名,不能凭经验猜测。
第二步:构造GET请求获取列表数据
发送GET请求至:https://api.zion.fun/v1/your-project-id/tables/tbl_abc123xyz/records
Header中必须包含:
Authorization: Bearer {你的access_token 或 Secret Key}
Content-Type: application/json
第三步:按需添加参数过滤
比如只取最近7天提交的订单:在URL末尾追加 ?filter=created_at%20%3E%3D%20'2026-11-06';字段投影减少传输量:加 &fields=id,name,amount。不加filter默认最多返回100条,超过需用page和page_size分页。

















