服务端 API/历史版本（不推荐）/云文档/电子表格/表格操作/导入表格
# 导入表格
>  为了更好地提升该接口的安全性，我们对其进行了升级，请尽快迁移至[新版本](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/import-user-guide)

该接口用于将本地表格导入到云空间上。
## 请求

基本 |  
---|---
HTTP URL | https://open.larksuite.com/open-apis/sheets/v2/import
HTTP Method | POST
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用**<br>开启任一权限即可 | 查看、评论、编辑和管理云空间中所有文件(drive:drive)<br>查看、评论、编辑和管理电子表格(sheets:spreadsheet)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `user_access_token` 或 `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：获取与使用access_token](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 请求体
| 参数          | 类型       | 必须 | 说明                                                         |
| ------------- | ---------- | ---- | ------------------------------------------------------------ |
| file          | array<byte> | 是   | 需要导入的文件数据，转换成字节数组的形式，支持"xlsx","csv"格式，最大不超过20M  |
| name          | string     | 是   | 文件名，带上文件拓展名，如"hello.csv"、"hello.xlsx"。导入后sheet的标题将去除文件拓展名，如"hello.xlsx"导入后标题为"hello"。           |
| folderToken   | string     | 否   | 导入的文件夹token，默认导入到根目录下                        |
### 请求体示例

```json
{
    "file": [80,75,3,......],
    "name": "name.xlsx",
    "folderToken": "fldxxxxx"
}
```
### cURL 请求示例
```
curl --location --request POST 'https://open.larksuite.com/open-apis/sheets/v2/import' \
--header 'Authorization: Bearer t-e346617a4acfc3a11d4ed24dca0d0c0fc8e0067e' \
--header 'Content-Type: application/json' \
--data-raw '{
    "file": [49,44,51,44,52,53,44,50,51,50,44,49,10,53,44,53,50,54,44,49,50,44,53,44,51,54,50,51,44,52,10,49,50,51,50,44,53,49,52,44,53,44,50,54,44,51,50,44,50,44,49,51,49,50],
    "name": "test.csv",
    "folderToken": "fldcncFpcEKOpsQhFpZD2VV6kXf"
}'
```
## 响应
### 响应体
| 参数   |类型| 说明                                             |
| ------ |-----| ------------------------------------------------ |
| ticket |string| 与导入文件一一对应的凭证，用于查询文件导入的进度，详见[查询导入结果的接口](https://open.larksuite.com/document/ukTMukTMukTM/uETO2YjLxkjN24SM5YjN)  |
### 响应体示例

```json
{
    "code": 0,
    "msg": "Success",
    "data": {
        "ticket": "6891610400000000"
    }
}
```
### 错误码

具体可参考：[服务端错误码说明](https://open.larksuite.com/document/ukTMukTMukTM/ugjM14COyUjL4ITN)