获取所有超链接 – Aspose.Cells Cloud REST API 文档

此 REST API 可从 Excel 工作簿中的指定工作表中检索所有超链接。

安全与身份验证

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

REST API

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

请求参数

参数名	类型	位置	是否必需	默认值	描述
name	string	path	是	–	Excel 文档的名称。
sheetName	string	path	是	–	工作表的名称。
folder	string	query	否	–	包含该文档的文件夹。
storageName	string	query	否	–	要使用的存储服务的名称。

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

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

请求

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

响应

{
  "Hyperlinks": {
    "Count": 4,
    "HyperlinkList": [
      {
        "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": null
  },
  "Code": 200,
  "Status": "OK"
}

JSON 响应中包含一个 Hyperlinks 对象：

Count – 工作表中超链接的总数。
HyperlinkList – 一个数组，其中每一项包含一个 link 对象。Href 属性存储超链接地址，Rel、Title 和 Type 提供额外元数据（对于简单链接通常为 null）。

错误响应

HTTP 状态码	原因	示例响应体
400	请求错误 – 参数缺失或无效。	`{ "Code":"400", "Message":"Invalid parameter value." }`
401	未授权 – 缺失或无效的 JWT 令牌。	`{ "Code":"401", "Message":"Access token is missing or invalid." }`
404	未找到 – 工作簿或工作表不存在。	`{ "Code":"404", "Message":"File not found." }`
500	服务器内部错误 – 意外的服务器故障。	`{ "Code":"500", "Message":"An unexpected error occurred." }`

云 SDK 产品族

使用 SDK 是集成该功能的最快方式。SDK 负责处理底层细节，使您能够专注于业务逻辑。请查看 GitHub 仓库获取 Aspose.Cells Cloud SDK 的完整列表。

以下代码示例展示了如何使用不同语言的 SDK 调用 Aspose.Cells Web 服务：

向工作表添加超链接