查询导入结果
该接口用于查询文件导入结果。查询30分钟无结果为导入失败。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/sheets/v2/import/result |
| HTTP Method | GET |
| 支持的应用类型 | custom,isv |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可 | drive:drive 查看、评论、编辑和管理云空间中所有文件 sheets:spreadsheet 查看、评论、编辑和管理电子表格 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | user_access_token 或 tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
| Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
查询参数
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| ticket | string | 是 | 导入时获取的凭证 |
cURL 请求示例
curl --location --request GET 'https://open.feishu.cn/open-apis/sheets/v2/import/result?ticket=6948310613016144800' \
--header 'Authorization: Bearer t-e346617a4acfc3a11d4ed24dca0d0c0fc8e0067e' \响应
响应体
| 参数 | 类型 | 说明 |
|---|---|---|
| ticket | string | 导入时获取的凭证 |
| url | string | 导入文档的链接 |
| warningCode | int | 导入的文档的状态码 |
warningCode的信息是以二进制数位存储的,每一位对应的含义如下:
| 5 | 4 | 3 | 2 | 1 | 0 |
|---|---|---|---|---|---|
| 文件夹不存在 | 图片导入失败 | 云空间图片超限 | 图片超过限制 | 格子被截断 | 列截断 |
以warningCode=18为例,18(十进制)=10010(二进制) ,对应的信息是「格子被截断」、「图片导入失败」
| 0 | 1 | 0 | 0 | 1 | 0 |
|---|---|---|---|---|---|
| 文件夹不存在 | 图片导入失败 | 云空间图片超限 | 图片超过限制 | 格子被截断 | 列截断 |
响应体示例
json
{
"code": 0,
"msg": "Success",
"data": {
"ticket": "6891610404246520328",
"url": "https://example.feishu.cn/sheets/shtcnaryaxxxx",
"warningCode": 32
}
}错误码
具体可参考:服务端错误码说明
