轻易云数据集成平台U8CDQG接口对接规范
轻易云数据集成平台U8CDQG接口对接规范
1. 数据查询配置指南
适配器路径:\Adapter\YYU8\U8CDQGQueryAdapter
关键配置项说明:
- 字段验证机制:由于接口文档未标注必填字段,建议通过轻易云平台的【测试沙箱】功能进行逐字段验证,平台支持自动记录测试轨迹
- 分页参数设置:
pagesize
:当前页码(从0开始计数)pagecount
:每页显示数量(设置为0时默认显示1条)
- 日期格式规范:存货查询接口要求
beginDate
/endDate
采用YYYY-MM-DD
短日期格式,其他接口需通过轻易云【智能探针】功能自动检测 - 级联查询配置:
responseKey
:主列表响应中标识详情的键值invokeKey
:详情接口调用参数名detailApi
:详情查询接口地址(支持轻易云动态URL构建功能)
2. 数据写入操作规范
适配器路径:\Adapter\YYU8\U8CDQGExecuteAdapter
核心注意事项:
- 参数传递优化:
- 仅需传递小数点后数值内容(轻易云【数据清洗】模块可自动提取)
- 通过平台【字段映射】功能实现源字段到目标字段的智能转换
- 复杂结构处理:
- 数组类型字段(如
mainModel.Details
)需配置轻易云【循环处理器】组件 - 平台自动生成类似
List<ModDispatchLists>
的结构化模板
- 数组类型字段(如
典型配置示例:
{
"dataProcessor": {
"decimalExtractor": {"sourceField": "amount", "precision": 2},
"arrayBuilder": {
"targetField": "Details",
"itemTemplate": "ModDispatchLists"
}
}
}
轻易云技术优势:平台内置300+预置适配器模板,支持通过低代码方式快速调整参数逻辑,相比传统开发方式可降低80%的对接耗时。