Получить правила условного форматирования Этот REST API возвращает правила условного форматирования, применённые к листу.
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации на основе JWT-токена .
REST API
GET https://api.aspose.cloud/v3.0/cells/{ name} /worksheets/{ sheetName} /conditionalFormattings
Параметры запроса
Имя параметра
Тип
Расположение
Описание
name
string
path
Имя файла Excel.
sheetName
string
path
Имя листа.
folder
string
query
Путь к папке, где хранится файл.
storageName
string
query
Имя службы хранения (необязательно).
Ответы об ошибках
Код HTTP
Причина
Пример тела ответа
400 Неверный запрос — отсутствуют или некорректны параметры.
{ "Code":"400", "Message":"Недопустимое значение параметра." }
401 Неавторизован — отсутствует или недействителен JWT-токен.
{ "Code":"401", "Message":"Отсутствует или недействителен токен доступа." }
404 Не найдено — книга или лист не существуют.
{ "Code":"404", "Message":"Файл не найден." }
500 Внутренняя ошибка сервера — непредвиденная ошибка сервера.
{ "Code":"500", "Message":"Произошла непредвиденная ошибка." }
Спецификация OpenAPI определяет общедоступное программное интерфейсное API и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Следующий пример демонстрирует, как выполнить вызов облачного API с помощью cURL.
Запрос
curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/sheet1/conditionalFormattings" \
\
"Content-Type: application/json" \
"Accept: application/json" \
"Authorization: Bearer <access_token>"
Ответ
{
"Status" : "OK" ,
"ConditionalFormattings" : {
"Count" : 1 ,
"ConditionalFormattingList" : [
{
"sqref" : "A1:B10" ,
"FormatConditions" : [
{
"Priority" : 1 ,
"Type" : "CellValue" ,
"Operator" : "GreaterThan" ,
"Formula1" : "100" ,
"Style" : {
"Font" : {
"Color" : { "A" : 255 , "R" : 255 , "G" : 0 , "B" : 0 },
"IsBold" : true
}
}
}
]
}
]
}
}
Приведённый выше пример содержит только наиболее релевантные поля, чтобы сделать полезную нагрузку компактной.
Параметры ответа
Параметр
Тип
Описание
Status
string
Результат выполнения запроса (например, OK ).
ConditionalFormattings
object
Контейнер данных об условном форматировании.
ConditionalFormattings.Count
integer
Количество возвращённых правил условного форматирования.
ConditionalFormattings.ConditionalFormattingList
array
Список объектов условного форматирования.
ConditionalFormattingList[].sqref
string
Диапазон ячеек, к которому применяется форматирование (например, A1:B10 ).
ConditionalFormattingList[].FormatConditions
array
Коллекция объектов условий форматирования для диапазона.
FormatConditions[].Priority
integer
Приоритет оценки условия.
FormatConditions[].Type
string
Тип условия (например, CellValue ).
FormatConditions[].Operator
string
Оператор, используемый для условия (например, GreaterThan ).
FormatConditions[].Formula1
string
Первая формула или значение условия.
FormatConditions[].Style
object
Стиль, применяемый при выполнении условия.
Style.Font.Color
object
Определение цвета шрифта в формате RGBA.
Style.Font.IsBold
boolean
Указывает, является ли шрифт полужирным.
Коды HTTP-статуса
Код
Значение
Описание
200
OK
Фильтр применён успешно; ответ содержит детали операции.
400
Неверный запрос
Отсутствуют или некорректны параметры (например, неподдерживаемый тип файла).
401
Неавторизован
Недействителен или отсутствует JWT-токен.
413
Полезная нагрузка слишком велика
Размер загружаемого файла превышает допустимый лимит.
500
Внутренняя ошибка сервера
Непредвиденная ошибка сервера.
Семейство облачных SDK
Использование SDK — это лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub .
Следующие примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK:
