Выгрузка через API

Экспорт подходит для передачи ограниченного набора доступных записей. Это не резервная копия: он не сохраняет всю конфигурацию, файлы, историю и структуру базы.

Выполнить запрос

Нужны scope exports:read, право export.execute и доступ владельца ключа к записям и полям.

POST /api/v1/exports HTTP/1.1
Host: service.example.invalid
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{"typeDefinitionId":"TYPE_ID","format":"JSON","limit":1000}

Формат — JSON или CSV; query необязателен. Ответ HTTP 200 — файл с Content-Type и Content-Disposition, а не обычный data/meta envelope. JSON содержит массив строк с ID, типом, состоянием, ревизией и разрешёнными значениями полей.

Ограничения полноты

По умолчанию limit 1000, допустимо 1–10 000. Предельный размер — 16 MiB. HTTP-ответ пока не передаёт признак truncated, который рассчитывается внутри сервиса. Поэтому совпадение количества выгруженных строк с limit требует отдельной проверки: возможно, данные обрезаны.

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

Работа с CSV

Значения, похожие на формулы электронных таблиц, экранируются. При последующем импорте учитывайте типы полей и преобразования. Для сложных значений удобнее JSON; CSV не является универсальным lossless-форматом всех структурированных полей.

Связанные статьи

• Метод exports
• Импорт
• Резервное копирование