数据导入
接口说明：批量导入数据到系统，支持Excel/JSON格式，需携带有效Token且拥有导入权限。
1. 接口信息
| 参数 |
说明 |
| 请求方式 |
POST |
| 接口地址 |
/api/v1/data/import |
| 是否需要授权 |
是 |
| 请求格式 |
multipart/form-data |
2. 请求参数
2.1 Header参数
| 参数名 |
必选 |
类型 |
说明 |
| Authorization |
是 |
string |
Bearer + Token |
2.2 FormData参数
| 参数名 |
必选 |
类型 |
说明 |
| dataType |
是 |
string |
数据类型：user/order等 |
| file |
是 |
file |
导入文件（Excel/JSON） |
| updateIfExist |
否 |
boolean |
存在则更新：true/false（默认false） |
3. 请求示例
POST /api/v1/data/import HTTP/1.1
Host: eimsnext.example.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="dataType"
user
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="users.xlsx"
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
(file content)
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="updateIfExist"
true
------WebKitFormBoundary7MA4YWxkTrZu0gW--
4. 响应结果
4.1 成功响应
200 OK
{
"code": 200,
"msg": "导入成功",
"data": {
"total": 10,
"success": 8,
"fail": 2,
"failMsg": ["第2行：手机号重复", "第5行：部门ID不存在"]
}
}
5. 错误码说明
| 错误码 |
说明 |
解决方案 |
| 401 |
Token无效或过期 |
重新获取Token |
| 403 |
无数据导入权限 |
分配对应权限 |
| 400 |
文件格式错误/参数错误 |
检查文件格式或参数 |
| 500 |
服务器内部错误 |
联系技术支持 |
6. 注意事项