创建导入任务

POST

/sdk/v2/api/files/v2/import

不支持导入0kb大小的文件

导入文件过程是一个异步处理过程，接口请求成功仅代表导入服务收到并开始处理导入请求，实际是否成功需要轮询获取导入进度接口查询导入任务是否完成。

导入支持的文件格式

石墨文件类型	支持导入的文件类型
document	.docx，.doc，.md，.txt
documentPro	.docx，.doc，.wps
spreadsheet	.xlsx，.xls，.csv, .xlsm
presentation	.pptx，.ppt

请求参数

Query 参数

Header 参数

Body 参数multipart/form-data

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff '/sdk/v2/api/files/v2/import?signature={{signature}}&token=123123' \
--header 'X-Shimo-Signature: {{signature}}' \
--header 'X-Shimo-Token: {{token}}' \
--form 'fileId="file-import-6"' \
--form 'type="document"' \
--form 'fileUrl="https://domain.com/files/download/test.docx"' \
--form 'fileName="test.docx"' \
--form 'importFontType="0"'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "status": 0,
    "message": "string",
    "data": {
        "taskId": "string"
    }
}

修改于 2026-06-22 02:43:30

文件导入说明

获取导入进度