# 获取旧版文档中的电子表格元数据warning 
此接口只支持获取旧版文档数据。要获取新版文档（`docx` 类型）中的元数据，使用[获取文档元数据](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/meta/batch_query)接口。

该接口用于根据 docToken 获取文档中的电子表格的元数据。 

## 请求

基本 |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/doc/v2/:docToken/sheet_meta
HTTP Method | GET
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用**<br>开启任一权限即可 | 查看、评论、编辑和管理云空间中所有文件(drive:drive)<br>查看、评论和下载云空间中所有文件(drive:drive:readonly)<br>查看、评论、编辑和管理文档(docs:doc)<br>查看、评论和导出文档(docs:doc:readonly)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `user_access_token` 或 `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 路径参数
|参数|类型|必须|说明|
|--|-----|--|----|
|docToken|string|是|doc 的 token，获取方式见 [如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN#08bb5df6)|

## 响应
### 响应体
|参数|说明|
|--|--|
|spreadsheetToken|sheet 的 token|
|sheets|doc 下的 sheet 属性|
|&emsp;∟sheetId|sheet 的 id|
|&emsp;∟title|sheet 的标题|
|&emsp;∟index|该 sheet 的位置|
|&emsp;∟rowCount|该 sheet 的行数|
|&emsp;∟columnCount|该 sheet 的列数|
### 响应体示例  
```json
{
    "code": 0,
    "msg": "Success",
    "data": {
        "spreadsheetToken": "string",
        "sheets": [
            {
                "sheetId": "string",
                "title": "string",
                "index": 0,
                "rowCount": 4,
                "columnCount": 4
            }
        ]
    }
}

```

### 错误码

错误码 | 说明 | 排查建议
---|---|---
91401 | PARAMERR | 参数出现错误，检查参数有效性
91402 | NOTEXIST | 未找到，检查token是否有效
91403 | FORBIDDEN | 没有权限，检查是否有文档读权限
91404 | LOGIN_REQUIRED | 需要登录
95001 | internal error | 内部错误，请稍后重试
95003 | internal error | 内部错误，请稍后重试
95005 | internal error | 内部错误，请稍后重试
95006 | Failed | 文档未找到，检查token是否有效
95007 | Failed | 文档已删除，已删除文件无法获取文档meta信息
95008 | FORBIDDEN | 检查用户对文档、文件夹的权限
95009 | Failed | 没有权限，检查是否有文档读权限。[添加文档权限](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/create)
95010 | internal error | 内部错误，请稍后重试
95011 | internal error | 内部错误，请稍后重试
95017 | 具体错误信息 | 读取文档内容失败，检查revison是否正确
95018 | 具体错误信息 | 解析文档内容失败，详见具体错误信息
95023 | revision too old | 版本号太老，请使用最新版本号
95024 | Failed | 参数无效，检查参数有效性
95053 | this API does not support the Upgraded Docs(docx), please refer to the https://feishu.feishu.cn/docx/ICI7dp1Uioh4EvxXn0HcxUapn0c using the correct API. | 此 API 不支持新版文档（docx），请参考[新版文档 OpenAPI 接入指引](https://feishu.feishu.cn/docx/ICI7dp1Uioh4EvxXn0HcxUapn0c)使用正确的 API。

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