Получить все гиперссылки – документация Aspose.Cells Cloud REST API

Этот REST API позволяет получить все гиперссылки из конкретного рабочего листа книги Excel.

Безопасность и аутентификация

API Aspose.Cells Cloud защищены и требуют аутентификацию с использованием токена 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. Пример ниже показывает, как вызвать API с помощью cURL.

Запрос

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":"Неверное значение параметра." }`
401	Неавторизован – отсутствует или некорректен токен JWT.	`{ "Code":"401", "Message":"Токен доступа отсутствует или некорректен." }`
404	Не найдено – книга или рабочий лист не существует.	`{ "Code":"404", "Message":"Файл не найден." }`
500	Внутренняя ошибка сервера – непредвиденный сбой сервера.	`{ "Code":"500", "Message":"Произошла непредвиденная ошибка." }`

Семейство облачных SDK

Использование SDK — самый быстрый способ интеграции данной функциональности. SDK обрабатывают низкоуровневые детали, позволяя вам сосредоточиться на бизнес-логике. Полный список облачных SDK Aspose.Cells Cloud доступен в репозитории GitHub.

Примеры кода ниже демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK:

Добавление гиперссылки в рабочий лист