Documentation – Получение одной строки из рабочего листа Excel с использованием API Aspose.Cells Cloud

Developer-Guide: Получить описание строки из рабочего листа Excel

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

Необходимые условия:

Получить действительный JWT-токен доступа и включить его в заголовок Authorization: Bearer <jwt token>.
Убедиться, что книга сохранена в облачном хранилище Aspose, либо указать путь к папке, где она расположена.
Использовать версию API v3.0, как показано в URL-адресе конечной точки.

Этот REST API извлекает данные строки по её индексу в рабочем листе Excel.

GetWorksheetRow API

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

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

API Aspose.Cells Cloud являются безопасными и требуют аутентификации по токену JWT.

Параметры запроса

Имя параметра	Тип	Расположение	Описание
name	string	path	Имя файла книги.
sheetName	string	path	Имя рабочего листа в книге.
rowIndex	integer	path	Индекс строки для извлечения (начинается с 0).
folder	string	query	Папка, содержащая книгу.
storageName	string	query	Имя хранилища, в котором находится книга.

Спецификация OpenAPI определяет общедоступное программное API-интерфейс и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. В следующем примере показано, как выполнять вызовы в облачный API с помощью cURL. Включите заголовок 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	Индекс возвращённой строки (начинается с 0).
`IsBlank`	boolean	Указывает, содержит ли строка какие-либо данные.
`IsHeightMatched`	boolean	`true`, если высота строки совпадает с высотой строки по умолчанию.
`IsHidden`	boolean	`true`, если строка скрыта.
`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 скрывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Полный список облачных SDK Aspose.Cells Cloud см. в репозитории на GitHub.

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

Developer-Guide: Получение информации о строках из рабочего листа Excel

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

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

Необходимые условия
Для вызова этого endpoint необходимо предоставить действительный JWT-токен в заголовке Authorization. Токен должен быть получен в рамках аутентификационного процесса Aspose.Cloud и включать необходимые области доступа для операций с файлами Cells. API использует схему версионирования v3.0 и подчиняется стандартным ограничениям по частоте запросов.

API GetWorksheetRows

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

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

API Aspose.Cells Cloud являются защищёнными и требуют аутентификации на основе JWT-токена.

Параметры запроса

Имя параметра	Тип	Расположение	Описание
name	string	path	Имя рабочей книги.
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/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 (OK)	Запрос успешно выполнен, информация о строках возвращена.
400	Bad Request (Неверный запрос)	Запрос имеет некорректный формат (например, отсутствуют обязательные параметры).
401	Unauthorized (Неавторизован)	Недействительный или отсутствующий JWT-токен.
404	Not Found (Не найдено)	Указанная рабочая книга или рабочий лист не существуют.
500	Internal Server Error (Внутренняя ошибка сервера)	На сервере произошла непредвиденная ошибка.

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

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

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

Запрос

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 обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Ниже приведены примеры кода на различных языках для получения строк рабочего листа.