# XLSX API в Sheet

Записывает JSON из REST/GraphQL в лист Excel

> Каноническая страница: https://elysiatools.com/ru/tools/xlsx-api-to-sheet

- **Категория:** Format Conversion

- **Ключевые слова:** xlsx, api, rest, graphql, pagination, json, mapping

## Обзор

Поддерживает автопагинацию и маппинг полей.

## Входные данные

- **Источник Type** (select)
- **URL API** (text): https://api.example.com/items
- **REST Метод** (select)
- **Заголовки JSON** (textarea): {"Authorization":"Bearer xxx"}
- **Запрос Параметры JSON** (textarea): {"status":"active"}
- **REST Тело JSON** (textarea): {"filters":{"status":"active"}}
- **GraphQL Запрос** (textarea): query($page:Int,$limit:Int){ items(page:$page,limit:$limit){ id name } }
- **GraphQL Переменные JSON** (textarea): {"status":"active"}
- **Данные Путь** (text): data.items
- **Пагинация Type** (select)
- **Макс Pages** (number)
- **Страница Param** (text)
- **Страница Начало** (number)
- **Страница Size Param** (text)
- **Страница Size** (number)
- **Параметр offset** (text)
- **Offset Начало** (number)
- **Параметр cursor** (text)
- **Cursor Начало** (text)
- **Has Еще Путь** (text): data.pageInfo.hasNextPage
- **Следующий Cursor Путь** (text)
- **Всего Pages Путь** (text): meta.totalPages
- **Поле Сопоставление JSON** (textarea): {"customer":"data.customer.name","amount":"amount"}
- **Имя листа** (text)
- **Вывод Файл Имя** (text): api-export

## Когда использовать

- Когда необходимо регулярно собирать данные из внешних API для формирования отчетов в Excel.
- При работе с API, использующими пагинацию (страницы, смещение или курсоры), для автоматического сбора всех записей.
- Когда требуется преобразовать сложные JSON-ответы в плоскую табличную структуру с выборочными полями.

## Как это работает

- Выберите тип источника (REST или GraphQL) и укажите URL конечной точки API.
- Настройте параметры пагинации, если данные разбиты на несколько страниц, чтобы инструмент автоматически собрал весь массив.
- Используйте функцию маппинга полей, чтобы сопоставить ключи JSON-ответа с нужными заголовками столбцов в Excel.
- Запустите процесс, чтобы получить готовый файл XLSX с данными, разложенными по листам.

## Сценарии использования

- Регулярная выгрузка списка товаров или заказов из CRM-системы в Excel для анализа продаж.
- Сбор данных из публичных API для маркетинговых исследований и последующей обработки в таблицах.
- Автоматизация формирования еженедельных отчетов о состоянии инфраструктуры на основе данных мониторинга.

## Частые вопросы

### Какие типы API поддерживает инструмент?

Инструмент поддерживает REST API (GET, POST, PUT, PATCH) и GraphQL API.

### Как работает автоматическая пагинация?

Вы можете выбрать тип пагинации (страницы, смещение или курсор) и указать параметры запроса, после чего инструмент будет запрашивать данные до достижения лимита или конца списка.

### Можно ли выбрать только определенные поля из JSON?

Да, используйте поле 'Поле Сопоставление JSON', чтобы указать, какие именно данные из ответа API должны попасть в конкретные столбцы Excel.

### Есть ли ограничение на количество загружаемых страниц?

Да, вы можете настроить параметр 'Макс Pages', чтобы контролировать объем данных и избежать чрезмерной нагрузки на API.

### В каком формате я получу результат?

Результатом работы инструмента является готовый файл в формате .xlsx, готовый к открытию в Excel или Google Таблицах.

## Связанные инструменты

- [Text to Excel Converter](https://elysiatools.com/ru/tools/text-to-excel): Convert various text formats to Excel with customizable parsing and formatting options
- [Встраиватель диаграмм XLSX](https://elysiatools.com/ru/tools/xlsx-chart-embedder): Создает изображения столбчатых или круговых диаграмм из диапазонов книги и вставляет их в Excel
- [Правила условного форматирования XLSX](https://elysiatools.com/ru/tools/xlsx-conditional-formatting-rule): Пакетно применяет условное форматирование к диапазонам Excel
- [Трансформер XLSX JSON](https://elysiatools.com/ru/tools/xlsx-json-transformer): Двустороннее преобразование JSON и Excel с разворачиванием/восстановлением
- [Разделитель XLSX по листам](https://elysiatools.com/ru/tools/xlsx-multi-sheet-splitter): Разбивает книгу с несколькими листами на отдельные файлы
- [Экспортер XLSX Parquet](https://elysiatools.com/ru/tools/xlsx-parquet-exporter): Экспортирует таблицы в Parquet/NDJSON для пайплайнов
- [Пакет настроек печати XLSX](https://elysiatools.com/ru/tools/xlsx-print-setup-pack): Настраивает бумагу, поля, масштаб, повтор заголовков и колонтитулы
- [Экстрактор диапазона XLSX](https://elysiatools.com/ru/tools/xlsx-range-extractor): Извлекает лист/диапазон/именованный диапазон в JSON

## Примеры

- [XLSX образцы](https://elysiatools.com/ru/samples/xlsx-samples): XLSX-образцы для тестов парсинга листов и извлечения данных
- [Postman Collections - API Тестирование](https://elysiatools.com/ru/samples/postman-collections): Всесторонние примеры Postman collections включая API тестирование, скрипты автоматизации, переменные окружения, mock серверы и продвинутые паттерны тестирования для REST API
- [XLS образцы](https://elysiatools.com/ru/samples/xls-samples): XLS-образцы для тестов бинарного парсинга и импорта электронных таблиц
- [Примеры OpenAPI/Swagger](https://elysiatools.com/ru/samples/openapi-swagger): Комплексные примеры документации API с использованием OpenAPI 3.0 и спецификаций Swagger для RESTful сервисов

## Связанные материалы

- [XLSX ETL: прием данных и передача в хранилище](https://elysiatools.com/ru/hubs/xlsx-etl-ingestion-workflows): Сведите несколько книг и CSV-источников в прослеживаемые результаты для SQL-загрузки, Parquet-пайплайна и пакетной обработки в объектном хранилище.
- [Рабочие процессы пакетов KPI-отчетов](https://elysiatools.com/ru/hubs/kpi-report-pack-workflows): Преобразуйте данные API и таблиц в KPI-дашборды, многостраничные Excel-пакеты, фирменные листы, диаграммы, спарклайны и PDF или Markdown отчеты.