Создание отчетов Excel с шаблонами Smart Marker – Руководство по API Aspose.Cells Cloud
Этот REST API создает рабочую книгу на основе шаблона Smart Marker.
API Smart Marker для рабочей книги
POST https://api.aspose.cloud/v3.0/cells/{name}/smartmarker
Безопасность и аутентификация
Aspose.Cells Cloud API защищены и требуют аутентификации по токену JWT.
Что такое Smart Marker?
Smart Marker — это синтаксис заполнителя, который связывает поля данных в XML- (или JSON-) файле с ячейками в шаблоне Excel. Во время выполнения Aspose.Cells заменяет маркеры соответствующими данными, что позволяет программно создавать полностью заполненные отчеты.
Параметры запроса
| Имя параметра | Тип | Описание |
|---|---|---|
| outPath | string | Путь назначения, куда будет сохранена созданная рабочая книга. |
| folder | string | Папка, содержащая исходную рабочую книгу. |
| storageName | string | Имя используемого сервиса хранилища. |
Параметр тела запроса
| Имя параметра | Тип | Описание |
|---|---|---|
| xmlFile | file | XML-файл данных Smart Marker, загруженный с запросом. |
Ответ
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
Примечания / Ограничения:
- API поддерживает файлы Excel размером до 50 МБ.
- Поддерживаемые форматы: только .xlsx, .xlsm и .xlsb.
- Ограничение скорости: 20 запросов в секунду на аккаунт.
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (ОК) | Фильтр применён успешно; ответ содержит детали операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизовано) | Недействительный или отсутствующий токен JWT. |
| 413 | Payload Too Large (Слишком большой запрос) | Загруженный файл превышает допустимый размер. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Как использовать API Smart Marker для рабочей книги
Спецификация API Smart Marker для рабочей книги
Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Использование SDK Aspose.Cells Cloud
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Следующий пример демонстрирует, как делать запросы к облачному API с помощью cURL.
Краткий пример (одна строка)
curl -X POST "https://api.aspose.cloud/v3.0/cells/{name}/smartmarker?outPath={outPath}" -H "Authorization: Bearer {access_token}" -F "xmlFile=@Sample_SmartMarker_Data.xml"
Обработка ошибок
| HTTP-статус | Описание | Типичная причина |
|---|---|---|
| 400 | Bad Request (Неверный запрос) | Отсутствует шаблон, некорректный XML или недопустимые параметры. |
| 401 | Unauthorized (Неавторизовано) | Недействительный или отсутствующий токен аутентификации. |
| 404 | Not Found (Не найдено) | Указанная рабочая книга или место хранилища не существует. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка на стороне сервера. |
Пример ответа об ошибке (400)
{
"Code": 400,
"Message": "XML-файл данных отсутствует или повреждён."
}
Семейство облачных SDK
Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub.
Следующие примеры кода демонстрируют, как вызывать веб-сервисы Aspose.Cells с использованием различных SDK: