从 Excel 工作簿中获取名称 – Aspose.Cells Cloud API

此 REST API 用于从 Excel 工作簿中检索已定义的名称。

安全与身份验证

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

GetWorkbookNames API

GET https://api.aspose.cloud/v3.0/cells/{name}/names

请求参数如下：

参数名称	类型	位置	描述
name	string	path	工作簿文件名。
folder	string	query	包含工作簿的文件夹。
storageName	string	query	要使用的存储空间名称。

请求必须包含以下 HTTP 请求头：

请求头	类型	描述
Authorization	string	Bearer JWT 令牌（必需）
Accept	string	`application/json`
Content-Type	string	`application/json`（仅适用于带请求体的请求）

身份验证 – 该 API 需要 OAuth2/JWT bearer token。请使用您的 client-id 和 client-secret 从 https://api.aspose.cloud/connect/token 获取令牌，并在每次请求中包含请求头 Authorization: Bearer <jwt token>。

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

您可使用 cURL 命令行工具访问 Aspose.Cells 网络服务。下面的示例演示了如何使用 cURL 调用 Aspose.Cells Cloud API。

请求

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/names" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

响应

{
  "Status": "string",
  "Names": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "Count": 0,
    "NameList": [
      {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        }
      }
    ]
  }
}

响应字段说明

Status (string) – 操作状态消息。
Names.link (object) – 该集合的超链接信息。
Names.Count (integer) – 返回的已定义名称总数。
Names.NameList (array) – 名称对象列表；每个对象包含一个 link 对象，提供导航详情。

错误处理 – 服务可能返回以下 HTTP 状态码：

状态码	含义	推荐操作
401	未授权	请确认是否提供了有效的 JWT 令牌。
404	未找到	请检查工作簿名称、文件夹和存储空间是否正确。
500	内部服务器错误	若问题持续存在，请稍后重试或联系 Aspose 支持。

云 SDK 开发工具包

使用 SDK 是最快捷的开发方式。SDK 处理底层细节，让您专注于业务逻辑。请查阅 GitHub 仓库，获取 Aspose.Cells Cloud SDK 的完整列表。

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

自动调整 Excel 工作簿中的行高计算 Excel 工作簿中的所有公式