# excel解析转换成json格式数据（API名称：excelToJson）
#### 功能介绍
该接口Excel表格数据导入后，转json返回
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| **请求方式** | **HTTPS地址**                                                | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/openFile/v1/file/excelToJson | OpenAPI  | application/json |
   
#### 请求头
| **KEY**       | VALUE                  | 是否必填 | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是    | 无                                                                                                |
| Authorization | bearer ${access_token} | 是    | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数** | **类型**        | **是否必填** | **描述**  |
|:---|:---|:---|:---|
| file   | MultipartFile | 是        | Excel文件 |
   
#### 响应参数
| **参数** | **类型** | **描述**         |
|:---|:---|:---|
| status | String | 状态码            |
| msg    | String | 成功时为空，异常时才有    |
| data   | String | Excel转json后的数据 |
   
data出参：
| **参数**   | **类型**          | **描述**       |
|:---|:---|:---|
| sheets   | Array\[Object\] | 每个excel页签的数据 |
| fileName | String          | 文件名称         |
   
sheets出参:
| **字段**  | **类型** | **描述**                                                                          |
|:---|:---|:---|
| name    | String | 页签名称                                                                            |
| data    | Array  | 页签数据,excel的每一行列数据，其中图片信息以excelPicId:为前缀，后带fileId，多个以英文逗号分隔，根据fileId进行图片下载见文件最下方 |
| merges  | Array  | 页签excel的单元格格式信息                                                                 |
| images  | Array  | 页签汇总的图片ID信息（上传后的）                                                               |
| maxRows | Int    | 单元格总行数                                                                          |
| maxCols | Int    | 单元格总列数                                                                          |
   
#### 请求示例
![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002522734567.png "点击放大")
#### 响应示例
```
{
    "status": "200 OK",
    "msg": "",
    "data": {
        "fileName": "结构化文档工艺导入模板（备注版）sheet1.xlsx",
        "sheets": [
            {
                "name": "（导入模板）一级工艺",
                "data": [
                    [
                        "标准作业指导书",
                        "* 车型",
                        "* 修程",
                        "* 工艺阶段",
                        "* 工艺名称",
                        "文档编号",
                        "* 参考资料",
                        "型号",
                        null,
                        null,
                        null,
                        null,
                        null,
                        null
                    ],
                ],
                "merges": [
                    {
                        "firstRow": 0,
                        "firstCol": 0,
                        "lastRow": 3,
                        "lastCol": 0
                    },
                ],
                "images": [
                    {
                        "4-8": "5050142"
                    }
                ],
                "maxCols": 14,
                "maxRows": 21
            }
        ]
    },
    "success": false,
    "failed": false
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。