Документация

Создание и настройка выгрузки

Выгрузка превращает собранные записи в файл или ответ для внешнего приложения. Она не запускает новый сбор с сайта. Один источник может иметь несколько выгрузок для разных получателей и структур данных.

Откройте и сохраните памятку, чтобы проверить сопоставление полей и полученный файл.

В примере Артикул передаётся в sku, Цена в price, Остаток в stock. Для двух записей CSV с разделителем ; выглядит так:

sku;price;stock
00123;1290.50;8
00124;;0

Два разделителя подряд обозначают пустую цену, а 0 в последней колонке означает нулевой остаток. В CSV нет типов: при импорте задайте столбцу артикула тип Текст, чтобы сохранить ведущие нули. Файл формируется из сохранённых записей и не запускает повторный сбор сайта.

Мастер создания

Способ получения. CSV для табличного обмена, JSON для вложенных объектов, XML для систем с теговой структурой, HTTP endpoint для запроса по ссылке, 1С-Битрикс для подключения сайта, Webhook для отправки JSON в ваш обработчик. Приглушённые модули с замком и подписью «Пока недоступно» выбрать нельзя.
Источник. Выберите сайт и понятное название. Код в ссылке создаётся автоматически; собственный можно указать в дополнительных настройках.
Начальная структура. Используйте все поля сайта, выберите поля вручную или опишите желаемый результат AI.

Карточка выгрузки

Обзор показывает источник, число записей и состояния настройки. «Поля настроены» означает наличие схемы, «Способ получения выбран»: выбор модуля. Это не подтверждение успешной доставки. Откройте пример и проверьте значения самостоятельно.

В Полях и обработке сопоставьте поле сайта с названием в результате. Для JSON путь product.price создаёт вложенность; окончание [] обозначает массив. В дополнительных параметрах находятся тип, заголовок CSV и поведение пустого значения. Сохраняйте изменения перед проверкой.

Пример результата использует небольшую выборку. Проверка пяти записей не доказывает, что весь каталог имеет одинаковую структуру. Для преобразования кодом проверка расходует вычислительное время.

В Получении данных можно изменить модуль, раскрыть параметры формата, получить ссылку или настроить автоматическую отправку. Смена модуля сохраняет поля; проверьте совместимость нового результата.

Первый файл

В Готовых файлах до первого запуска находится кнопка Подготовить файл. После запуска появляются история и состояние подготовки. Дождитесь завершения, откройте результат и скачайте файл. Неудачные подготовки сохраняются в истории, чтобы можно было прочитать причину.

Форматы · Обработка кодом · API выгрузки · 1С-Битрикс

Webhook

Выберите модуль Webhook, задайте источник и настройте структуру, как для любой другой выгрузки. Поддерживаются поля, вложенность, преобразование каждой записи и обработка всего набора кодом. В «Получении данных» доступны параметры JSON: корневой контейнер, форматирование и группировка. Посмотреть JSON показывает результат на небольшой выборке, а не отправляет его получателю.

Нажмите Настроить получателя. Укажите адрес HTTP-обработчика и секрет подписи от 16 до 128 символов. Можно сгенерировать секрет и скопировать его; сохраните тот же секрет в своём сервисе. После сохранения значение скрыто. Пустое поле при изменении получателя сохраняет прежний секрет. Для рабочего подключения используйте HTTPS.

Данные отправляются методом POST с Content-Type: application/json. Тело имеет именно вашу структуру, без дополнительной обёртки. Один запрос содержит до 100 записей и 1 МиБ. Параметры JSON применяются к каждой пачке отдельно. Для общих итогов по всему каталогу используйте обработку набора кодом (до 10 000 входных записей/16 МиБ).

Доступны ручная отправка, запуск после успешного сбора и расписание cron (UTC). Отправить сейчас ставит доставку в очередь. Ход и результат видны в Истории отправок. Если нужно несколько получателей, добавьте правила доставки.

Обработчик должен проверить подпись, сохранить данные и только затем ответить 2xx. X-Parser-Signature-256 содержит t=<время>,v1=<подпись>: подпись вычисляется как HMAC-SHA256 от строки время.сырое_тело с вашим секретом. Сравнивайте подписи через constant-time функцию и отклоняйте слишком старые метки времени. X-Parser-Event равен export.records, X-Parser-Export содержит код выгрузки, X-Parser-Count — число записей в запросе.

При сетевой ошибке, 408, 429 или 5xx выполняются до 3 попыток. В повторах сохраняются те же байты и Idempotency-Key (также X-Parser-Delivery); обработчик должен распознавать этот ключ и не создавать дубли. Ошибки 3xx и остальные 4xx не повторяются. После неудачи причина остаётся в истории. Уже подтверждённые пачки не откатываются.

При ручном повторе запуска некоторые записи могут прийти ещё раз с новым ключом отправки. Добавьте стабильный _key в схему и обновляйте записи у себя по нему. Для удаления передавайте _deleted. После смены URL отметка сохраняется: если новому получателю нужен весь каталог, отдельно сбросьте отметку доставки.