批量导入选项(自定义档案)分类信息
业务场景
该接口用于批量更新或保存选项分类信息。
接口说明
- 单次导入不能超过50条
- 当需要加入到某个父分类下成为其子分类时，得先保证父分类已存在系统内（即不能在一批数据内既新增分类又将其作为其他分类父级）
- 本接口采用部分失败模式，一条数据失败不影响其他正确数据
接口限制
10次/秒/企业
接口地址
/api/openapi/reference/data/category
请求类型
POST
请求参数
请求参数说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| refDataCategories |
List<refDataCategory> |
是 |
选项分类信息 |
| bizCode |
string |
是 |
选项组code（全局唯一） |
refDataCategory 参数说明：
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| name（中文） |
String |
否 |
分类名称(同一父类下唯一) |
| nameEn（英文） |
string |
否 |
分类英文名称(同一父类下唯一) |
| bizCode |
string |
是 |
分类code（同一自定义档案下唯一） |
| parentBizCode |
string |
否 |
父类分组编码 |
请求示例
{
"bizCode": "SYX54321",
"refDataCategories": [
{
"name": "测试用选项分类2",
"nameEn": "测试用选项分类2",
"bizCode": "test-002",
"parentBizCode": "test-001"
},
{
"name": "测试用选项分类3",
"nameEn": "测试用选项分类2",
"bizCode": "test-003"
}
]
}
响应参数
响应参数说明
| 字段 |
字段类型 |
字段说明 |
| code |
String |
返回结果 |
| message |
String |
返回提示 |
| data |
Json |
返回结果，为null则代表都成功 |
| success |
boolean |
是否成功 |
data.errorData数据参数说明
| 字段 |
字段类型 |
字段说明 |
| key |
String |
主键，对应错误参数 |
| errorMessage |
String |
返回提示 |
| errorIndex |
Json |
错误信息的数据下标 |
正常响应参数示例
{
"code": "ACK",
"message": "",
"data": null,
"errorCode": null,
"success": true
}
正常响应参数示例
{
"code": "NACK",
"message": "",
"data": {
"errorData": [
{
"key": "test-001",
"errorCode": "999997",
"errorMessage": "无效参数",
"errorIndex": 0
}
]
},
"errorCode": null,
"success": false
}
修改记录
2020-02-22 增加nameEn字段，name和nameEn这两个字段必填一个
2020-03-02 原来的nameZh已废弃，name和nameEn这两个字段必填一个