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

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

Получить действительный 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: