查询工作表

GET

/sheets/v3/spreadsheets/{spreadsheet_token}/sheets/{sheet_id}

该接口用于通过工作表ID查询工作表属性信息。

错误码

HTTP状态码	错误码	描述	排查建议
400	1310251	Invalid Parameter	参考响应体中的错误提示
400	1310213	Permission Fail	没有文档相应权限
400	1310249	Spreadsheet Deleted	恢复表格后重试
400	1310214	SpreadSheet Not Found	检查表格 token
500	1315201	Server Error	服务内部错误，详询客服
500	1315203	Server Error	服务内部错误，详询客服
500	1315210	Server Error	服务内部错误，详询客服

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/sheets/v3/spreadsheets/shtxxxxxxxxxxxxxxx/sheets/giDk9k' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "sheet": {
            "sheet_id": "sxj5ws",
            "title": "title",
            "index": 0,
            "hidden": false,
            "grid_properties": {
                "frozen_row_count": 0,
                "frozen_column_count": 0,
                "row_count": 200,
                "column_count": 20
            },
            "resource_type": "sheet",
            "merges": [
                {
                    "start_row_index": 0,
                    "end_row_index": 0,
                    "start_column_index": 0,
                    "end_column_index": 0
                }
            ]
        }
    }
}

修改于 2025-10-21 05:57:04

创建表格

获取工作表

查询工作表

错误码#

请求参数

返回响应

错误码