Title: 🔗 接口引擎：类型化数据能力
Canonical: https://microi.net/doc/system-engine/datasource-engine.html
Page-Modified: 2026-09-03T21:45:51.000Z
Source: published HTML document body; page revision is not a capability verification date.

# 🔗 接口引擎：类型化数据能力

原入口兼容说明

“数据源引擎”已不再作为独立引擎、新建入口或培训专题。从 v7.7.2 起，原有的 V8、SQL、JSON 数据源能力已统一集成到接口引擎，由 sys_apiengine、DataSourceType 与唯一源码字段 ApiV8Code 承载。

新项目请直接阅读并使用接口引擎的类型化数据能力 (https://microi.net/doc/v8-engine/api-engine.html#%E7%B1%BB%E5%9E%8B%E5%8C%96%E6%95%B0%E6%8D%AE%E8%83%BD%E5%8A%9Bv8--sql--json)。本页仅为旧书签、历史项目和升级排查保留，不再出现在官网左侧引擎导航中。

## 现在应该怎么配置

业务场景	|	接口引擎配置	|	ApiV8Code 内容	|

参数校验、权限过滤、组合查询、第三方服务	|	留空或 V8	|	服务端 JavaScript	|

当前租户内、管理员审核过的固定只读查询	|	SQL	|	参数边界明确的查询 SQL	|

非敏感静态字典或配置	|	JSON	|	标准 JSON	|

历史 ApiDataSource 迁移记录	|	API	|	仅保留原文供复核，应改写为 V8.Http	|

所有类型都复用接口引擎的 ApiEngineKey、角色权限、匿名策略、启停状态、日志、测试参数与调用边界。新代码统一调用：

js

```
var result = V8.ApiEngine.Run('product_options', {
  Keyword: V8.Param.Keyword || ''
});
return result;
```

SQL 类型不得直接拼接用户输入、原始 _Where、Token 或前端提交的用户对象；需要动态条件、字段白名单或复杂权限时，切换为 V8，并使用 V8.FormEngine + _Where 或 V8.Db.FromSql(...).AddInParameter(...)。

## 历史项目如何兼容

后端升级会在单个数据库事务内把未删除的 sys_datasource 迁移到 sys_apiengine：

- 原 V8、SQL、JSON 源码归一写入 ApiV8Code，并设置对应 DataSourceType。

- 角色、匿名、启用状态、测试参数、Key 和 Id 尽量保留；冲突时创建稳定映射。

- 只有新接口记录全部写入成功，旧记录才标记为删除；任一步失败都会回滚。

- 旧字段保留的 DataSourceId、旧 V8.DataSourceEngine.Run 及历史 HTTP 地址继续通过兼容层定位迁移后的接口引擎。

兼容地址包括：

- /api/DataSourceEngine/Run

- /api/DataSourceEngine/GetData

- /apiengine/platform-data-source-run

兼容入口只用于存量系统平滑升级。新表单字段、报表、界面和外部集成都应直接绑定稳定且租户内唯一的 ApiEngineKey，并使用 V8.ApiEngine.Run。

完整开发方法见接口引擎 (https://microi.net/doc/v8-engine/api-engine.html)，统一安全边界见平台安全与兼容基线 (https://microi.net/doc/more/security.html)。