本文档由石墨办公提供。

创建导入任务

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 参数application/json

示例

{
    "fileId": "string",
    "type": "string",
    "fileUrl": "string",
    "fileName": "string",
    "importFontType": "string"
}

请求示例代码

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-Weboffice-Signature: {{signature}}' \
--header 'X-Weboffice-Token: {{token}}' \
--header 'Content-Type: application/json' \
--data '{
    "fileId": "string",
    "type": "string",
    "fileUrl": "string",
    "fileName": "string",
    "importFontType": "string"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

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

修改于 2026-09-15 02:47:44

文件导入说明

获取导入进度