Documentation – 使用 Aspose.Cells Cloud API 从 Excel 工作表中检索单行数据

Developer-Guide: 从 Excel 工作表中获取行描述

Mon, 01 Jan 0001 00:00:00 +0000

前置条件：

获取有效的 JWT 访问令牌，并将其包含在 Authorization: Bearer <jwt token> 请求头中。
确保工作簿已存储于 Aspose Cloud 存储中，或指定其所在文件夹路径。
使用 API 版本 v3.0，如端点 URL 所示。

该 REST API 可根据行索引检索 Excel 工作表中的行数据。

GetWorksheetRow API

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/{rowIndex}

安全与身份验证

Aspose.Cells Cloud API 采用安全机制，需使用基于 JWT 令牌的身份验证。

请求参数

参数名称	类型	位置	描述
name	string	path	工作簿文件的名称。
sheetName	string	path	工作簿内工作表的名称。
rowIndex	integer	path	要检索行的从零开始的索引。
folder	string	query	包含工作簿的文件夹路径。
storageName	string	query	工作簿所在存储的名称。

OpenAPI 规范定义了一个公开可用的编程接口，允许您直接通过 Web 浏览器执行 REST 交互。

您可使用 cURL 命令行工具轻松访问 Aspose.Cells 网络服务。以下示例展示了如何使用 cURL 调用 Cloud API。请在请求头中包含 Authorization: Bearer <jwt token> 以完成身份验证。

请求

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/0" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

响应

{
  "Row": {
    "GroupLevel": 0,
    "Height": 13.5,
    "Index": 0,
    "IsBlank": false,
    "IsHeightMatched": true,
    "IsHidden": false,
    "Style": {
      "link": {
        "Href": "/style",
        "Rel": "self"
      }
    },
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/cells/rows/0",
      "Rel": "self"
    }
  },
  "Code": 200,
  "Status": "OK"
}

响应架构

属性	类型	描述
`GroupLevel`	integer	行的分级层级（用于分组）。
`Height`	number	行高（单位为磅）。
`Index`	integer	返回的行的从零开始的索引。
`IsBlank`	boolean	是否该行不包含任何数据。
`IsHeightMatched`	boolean	行高是否与默认行高一致。
`IsHidden`	boolean	行是否处于隐藏状态。
`Style`	object	包含该行样式信息的对象。
`link`	object	指向该行资源的超链接引用。
`Code`	integer	响应的 HTTP 状态码。
`Status`	string	状态的文本描述（例如，“OK”）。

说明 / 错误处理： 该 API 可能返回以下 HTTP 状态码：

200 – 成功；返回行数据。
401 – 未授权；JWT 令牌缺失或无效。
404 – 未找到；指定的工作簿、工作表或行不存在。
500 – 服务器内部错误；发生意外情况。

状态码	描述	解决方案
200	成功 — 返回行数据。	—
401	未授权 — 缺失或无效的 JWT 令牌。	提供有效的 JWT 令牌。
404	未找到 — 工作簿、工作表或行缺失。	核实文件名、工作表名及行索引。
500	服务器内部错误 — 意外情况。	联系 Aspose 技术支持。

完整错误码列表，请参阅 Aspose.Cells Cloud 错误码文档。

云 SDK 家族

使用 SDK 是开发的最快方式。SDK 抽象了底层细节，让您专注于项目任务。请查看 GitHub 仓库，获取 Aspose.Cells Cloud SDK 的完整列表。

以下代码示例展示了如何使用不同 SDK 调用 Aspose.Cells 网络服务：

Developer-Guide: 从 Excel 工作表获取行信息

Mon, 01 Jan 0001 00:00:00 +0000

此 REST API 可从 Excel 工作表中检索行信息。

前置条件
要调用此端点，您必须在 Authorization 请求头中提供有效的 JWT 令牌。该令牌需通过 Aspose.Cloud 身份验证流程获取，并必须包含 Cells 操作所需的权限范围。该 API 遵循 v3.0 版本规范，并受标准速率限制策略约束。

GetWorksheetRows API

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows

安全与身份验证

Aspose.Cells Cloud API 是安全的，需要基于 JWT 令牌的身份验证。

请求参数

参数名称	类型	位置	描述
name	string	path	工作簿名称。
sheetName	string	path	工作表名称。
folder	string	query	工作簿所在文件夹。
storageName	string	query	存储名称。

OpenAPI 规范定义了一个公开可访问的编程接口，让您能直接从网页浏览器中执行 REST 交互。

您可使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例展示了如何通过 cURL 调用 Cloud API。

请求

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

响应

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

响应码

码值	含义	描述
200	OK（成功）	请求成功，行信息已返回。
400	Bad Request（错误请求）	请求格式错误（例如缺少必需参数）。
401	Unauthorized（未授权）	JWT 令牌无效或缺失。
404	Not Found（未找到）	指定的工作簿或工作表不存在。
500	Internal Server Error（内部服务器错误）	服务器发生意外错误。

云 SDK 家族

使用 SDK 是加速开发的最佳方式。SDK 负责处理底层细节，使您能专注于项目任务本身。请查阅 GitHub 仓库，获取 Aspose.Cells Cloud SDK 的完整列表。

以下代码示例展示了如何使用多种 SDK 调用 Aspose.Cells Web 服务：

请求

curl -X GET "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows" -H "accept: application/json"

响应

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

云 SDK 家族

使用 SDK 是加速开发的最佳方式。SDK 负责处理底层细节，使您能专注于项目任务本身。以下提供了按语言分类的获取工作表行信息的代码示例：