Получение выгрузки по API

Endpoint отдаёт актуальные сохранённые записи по настроенной схеме. Запрос не запускает парсинг сайта. Используйте его для интеграции с магазином, учётной системой или собственным приложением.

Подключение

1. Откройте выгрузку → Получение данных.
2. Выберите HTTP endpoint и нужный формат: JSON, XML или CSV.
3. Скопируйте адрес. Создайте токен доступа к этой выгрузке и сохраните его на сервере получателя. Значение показывается только один раз.
4. Выполните запрос с заголовком Authorization: Bearer ....
5. Проверьте первую страницу и настройте переход по курсору.

curl --fail-with-body \
  -H "Authorization: Bearer $EXPORT_TOKEN" \
  'https://YOUR_HOST/api/export/SITE_CODE/EXPORT_CODE.json?limit=100'

Замените YOUR_HOST, SITE_CODE и EXPORT_CODE значениями своей установки. Адрес localhost доступен только на том компьютере, где выполняется запрос; внешнему получателю нужен доступный HTTPS-адрес платформы.

Страницы данных

JSON по умолчанию содержит данные и служебное описание. Для простого вывода используйте envelope=0, если это подходит вашему получателю. Продолжение находится в cursor / has_more и заголовках X-Export-Cursor, X-Export-Has-More. X-Export-Count показывает количество записей в ответе.

Передайте полученный курсор параметром after следующего запроса. Сохраняйте курсор только после успешной обработки всей страницы. limit: от 1 до 10 000, по умолчанию 1000. Метаданные доступны по адресу без расширения с окончанием /meta. Не путайте эту курсорную схему с page в списках управляющего API.

Обновления и удаления

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

Доступ и ошибки

Токен выгрузки ограничивается сайтами, профилями, форматами, сроком, частотой и, если настроено, IP-адресами. После смены формата проверьте разрешения токена. Не помещайте ключ в URL: он может попасть в историю и журналы.

401: неверный токен; 403: нет доступа; 402: ограничение биллинга; 422: параметры или обработка; 429: слишком много запросов. Подготовка ответа расходует время обработки. Подробнее: лимиты.

Этот токен не создаёт сайты или сценарии. Для управления ресурсами нужен отдельный API-ключ.