Zion支持标准RESTful API输出,进入「设置」→「API与集成」可见「已启用标准RESTful API服务」,点击「查看API文档」可生成OpenAPI 3.0规范;支持新建数据接口并配置Token鉴权或IP白名单,生成带过滤能力的HTTPS接口;外部系统可通过curl或Python requests调用,返回JSON数据;还支持Webhook对接钉钉/飞书等,触发事件实时推送。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

需要让外部系统实时获取Zion应用中已建模的数据表内容,比如ERP要拉取客户订单状态、BI工具要接入销售数据源、或者微信小程序要展示最新商品列表——这些场景都依赖Zion能否对外暴露稳定、可控、带权限校验的接口能力。
确认Zion是否支持标准API输出
登录Zion平台后,进入任意已发布应用的「设置」→「API与集成」页签,页面顶部明确显示「已启用标准RESTful API服务」,说明该功能默认开启,无需额外开通或付费升级。
点击「查看API文档」按钮,系统自动生成当前应用所有数据表的完整OpenAPI 3.0规范文档,含路径、请求方法、参数定义、示例响应及认证方式说明。
生成并配置专属数据接口
在「API与集成」页,点击「新建数据接口」→选择目标数据表(如「订单表」)→勾选需开放的字段(避免全量导出敏感字段)→设置访问权限模式。
【必须选择「Token鉴权」或「IP白名单」之一,否则接口将无法被外部调用】 若选Token鉴权,系统自动生成一对有效期为365天的API Key与Secret;若选IP白名单,需手动填入外部系统出口IP(支持CIDR格式,如192.168.1.0/24)。
保存后,接口URL即时生成,形如:https://api.yourapp.zion.dev/v1/orders?status=shipped,支持GET参数过滤,也支持POST提交JSON进行复杂查询。
在外部系统中调用Zion接口
方法一:使用curl直接测试
复制刚生成的API Key,在终端执行:curl -H "Authorization: Bearer <your_api_key>" https://api.yourapp.zion.dev/v1/orders?limit=10</your_api_key>,返回JSON即表示通路正常。
方法二:在Python中调用
安装requests库后,写入以下代码即可获取数据:
import requests<br>headers = {"Authorization": "Bearer your_api_key"}<br>r = requests.get("https://api.yourapp.zion.dev/v1/orders", headers=headers)<br>print(r.json())
注意:若返回401错误,检查API Key是否过期或被误删;若返回403,确认调用IP是否在白名单内或Token是否拼写错误。
对接第三方系统(如钉钉/飞书/企业微信)
第一步:进入Zion「API与集成」→「Webhook配置」→点击「新增Webhook」
第二步:填写目标平台提供的接收地址(如飞书机器人的Webhook URL)→选择触发事件(如「订单表新增记录」)→勾选要推送的字段(建议仅推ID和关键状态字段,避免超长报文)
第三步:点击「启用」→系统立即向该地址发送一条测试消息,收到200响应即完成绑定。
此后,只要Zion中订单表有新记录插入,飞书群就会自动收到结构化通知,无需外部轮询或定时拉取。


















