CSV в JSON: таблица для API и тестовых данных

CSV в JSON нужен, когда таблица уже есть в файле или Excel, а в код и API удобнее отдать массив объектов. Первая строка с именами колонок становится ключами; каждая следующая строка это один объект. Разделитель в русской выгрузке часто «;», в международных файлах обычно запятая. Кодировка UTF-8 или Windows-1251 решает, останется ли кириллица читаемой. Откройте CSV в JSON на Тулси: вставьте текст или загрузите файл, проверьте разделитель и кодировку, скопируйте или скачайте .json. Обработка идёт в браузере на вашем устройстве, без отправки данных на сервер. Ниже: когда конвертация ломается, как подготовить таблицу, путь в инструменте и соседние утилиты JSON в CSV, CSV в Excel и JSON formatter. Частые вопросы собраны в конце.

Почему таблицу неудобно тащить в код как есть

CSV хранит сетку: заголовок, строки, ячейки через разделитель. Скрипт и фронтенд ждут структуру: массив объектов с именованными полями. Если вы вставите .csv в переменную как текст, парсер JSON его не примет.

Люди ищут «csv файл в json» и «таблица csv в json», когда нужна фикстура для теста API, импорт списка в код или обмен с фронтендом. Обратный путь (ответ API в таблицу) закрывает статья JSON в CSV для Excel и инструмент JSON в CSV.

Типичный исходник: первая строка id;name;city, дальше 1;Анна;Казань. На выходе ждут [{ "id": "1", "name": "Анна", "city": "Казань" }]. Сложность начинается, когда разделитель другой, заголовков нет или кириллица «поехала».

Когда без конвертера не обойтись

Выгрузка из 1С или Excel на сотню строк: руками объекты не набьёте. Коллега прислал CSV, а в Postman нужен JSON body. Разовый тест API: писать скрипт на Python дольше, чем открыть вкладку.

В этих случаях быстрее загрузить CSV в конвертер в браузере, получить массив объектов и вставить его в код или запрос. Для ежедневного пайплайна уже пишут код в репозитории; для разовой фикстуры хватает страницы на Тулси.

Чем CSV отличается от готового JSON

В JSON имя поля сидит в каждом объекте. В CSV имя колонки одно на весь файл и живёт только в первой строке. Без заголовков конвертер не знает, как назвать ключи: либо подставит индексы, либо откажет. Держите первую строку осмысленной: user_id, email, status, а не столбец1.

Ячейки в CSV это текст. Числа и булевы значения часто останутся строками ("1", "true"), пока вы сами не приведёте типы в коде. Для тестовых данных API это обычно нормально: сервер сам приведёт типы по схеме.

Что можно сделать самому до браузера

Иногда конвертация не нужна. Три строки и два поля вы набьёте вручную в редакторе. Если файл открывается иероглифами уже в Excel, сначала чините кодировку: иначе в JSON уедет та же каша.

Держите в голове два шага: читаемый CSV и понятные заголовки. Без первого объекты соберут мусор. Без второго ключи будут бесполезны для кода.

Локально можно написать пару строк на Python или открыть таблицу в редакторе с плагином. Для куска из тикета или чата быстрее вкладка на сайте: без установки и сохранения промежуточных скриптов.

Проверка таблицы до конвертации

Откройте файл в текстовом редакторе, не только в Excel. Убедитесь, что первая строка это имена колонок, а не пустая строка и не «Шапка отчёта». Посмотрите, чем разделены поля: ;, , или таб.

Если кириллица уже кракозябры в редакторе, смените кодировку при открытии или прогоните файл через CSV в Excel и сохраните заново. Разбор типичных сбоев: CSV в Excel без иероглифов.

Когда достаточно редактора и скрипта

Если вы каждый день гоняете одну и ту же выгрузку в фикстуры, имеет смысл закрепить скрипт в репозитории. Разовая таблица на двадцать строк это другой сценарий: копирование в CSV в JSON займёт меньше времени, чем настройка окружения.

Для ответа API, который уже лежит JSON и нужен в Excel, конвертер CSV→JSON не поможет. Там обратный инструмент: JSON в CSV и статья JSON в CSV для Excel.

Как подготовить CSV перед вставкой

Качество JSON зависит от формы исходника. Лучший вариант: первая строка с уникальными именами колонок, дальше строки с тем же числом полей. Тогда каждый объект соответствует одной строке, а ключи берутся из заголовков.

Пустые строки в конце файла лучше убрать: иначе получите пустой объект или объект с пустыми строками. Кавычки вокруг полей с разделителем внутри оставляйте по правилам CSV; конвертер обычно их снимает при разборе.

Перед вставкой решите, какой разделитель в файле. Русский Excel и многие учётные системы пишут «;». Google Таблицы и зарубежные экспорты чаще ставят запятую. Режим «Авто» на Тулси часто угадывает сам; при сомнении выберите вручную.

Откуда брать исходник

Из Excel: «Сохранить как» → CSV, не скриншот листа. Из почты или мессенджера: скачайте вложение целиком, не копируйте кусок из превью. Из 1С и старых систем: проверьте кодировку Windows-1251.

Если в буфер попала только середина таблицы без заголовков, допишите первую строку с именами колонок. Без неё ключи в JSON будут бессмысленны для API.

Частые ошибки подготовки

Сохранили «Unicode-текст» или странный диалект CSV с табами и ждали разбор как запятую. Оставили две строки заголовков (название отчёта + имена колонок). Скопировали из Excel так, что ячейки слиплись в одну колонку без разделителя.

В каждом случае сначала приведите текст к одной строке заголовков и ровным столбцам. Потом вставляйте в конвертер. Вложенные «таблицы внутри ячейки» плоский JSON из CSV сам не развернёт: одна ячейка станет одним строковым полем.

Как пройти путь в CSV в JSON на Тулси

Откройте CSV в JSON. Вставьте текст в поле или загрузите файл. Проверьте разделитель: авто, запятая, «;» или таб. Если кириллица подозрительна, выберите UTF-8 или Windows-1251.

Инструмент соберёт массив объектов: ключи из первой строки, значения из остальных. Скопируйте результат или скачайте файл .json. Вставьте в код, Postman или фикстуру и проверьте пару объектов глазами.

Если JSON «кривой» синтаксически (скобки, запятые), откройте его в JSON formatter. Если синтаксис верный, но ключи или значения не те, вернитесь к CSV: заголовки, разделитель, кодировка.

Выбор разделителя и кодировки

Для выгрузок из русского Excel чаще ставьте «;». Запятая подходит файлам из Google Таблиц и многим международным экспортам. Если в JSON одна длинная строка вместо набора полей, разделитель выбран неверно: смените его и повторите.

Кодировка. UTF-8 это обычный случай для современных файлов. Windows-1251 встречается в старых выгрузках и части российских систем. Режим «Авто» часто справляется; при кракозябрах в ключах или значениях переключите вручную.

Копирование и скачивание

Копирование удобно для короткой фикстуры: вставили в буфер, открыли редактор или Postman, вставили. Скачивание .json удобнее для сотен строк и передачи коллеге. Имя файла роли не играет; важнее, что это валидный массив объектов.

Если после вставки в код парсер ругается, проверьте, что скопировали весь массив от [ до ]. Хвост иногда обрезают в чате. Formatter покажет, где оборвалась структура: как найти ошибку в JSON.

Как проверить результат и что делать при ошибке

Успех: в JSON массив, число объектов близко к числу строк данных, ключи совпадают с заголовками CSV, кириллица читается. Откройте два-три объекта и сверьте значения с исходной таблицей.

Неудача «одна простыня вместо объектов»: часто виноват разделитель. Неудача «ключи Column1 / пустые / кракозябры»: нет нормальной строки заголовков или сломана кодировка. Неудача «парсер JSON ругается»: обрезали хвост при копировании или вручную правили результат.

Данные на Тулси в этом инструменте не уходят на сервер: конвертация идёт на устройстве. Для тестовых списков с персональными полями это обычно приемлемый режим. Если политика компании запрещает вставку любых данных во внешние страницы, используйте локальный скрипт в закрытом контуре.

Смежные задачи рядом с таблицами и API

Обратный путь (массив объектов в таблицу для Excel) закрывает JSON в CSV и статья JSON в CSV для Excel. Если CSV открывается иероглифами ещё до JSON, сначала CSV в Excel и разбор без иероглифов.

Если структура JSON сомнительна после конвертации, сначала JSON formatter. Практика поиска ошибки: JSON formatter: как найти ошибку. Для полей-дат в Unix-секундах рядом лежит Unix timestamp в дату.

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

Как преобразовать CSV файл в JSON?

Возьмите CSV с заголовками в первой строке, откройте CSV в JSON, вставьте текст или загрузите файл, проверьте разделитель и кодировку. Каждая строка данных станет объектом, имена колонок станут ключами. Скопируйте массив или скачайте .json и вставьте в скрипт или запрос API.

Как сделать таблицу CSV в JSON для теста API?

Подготовьте плоскую таблицу с колонками, которые ждёт ваш эндпоинт: id, email, status и т.п. Прогоните файл через CSV в JSON и получите массив объектов для тела запроса или фикстуры. Типы (число, булево) при необходимости приведите в коде: из CSV поля часто приходят строками. Для обратного сценария (ответ API в таблицу) используйте JSON в CSV.

Какой разделитель выбрать: запятую или точку с запятой?

Смотрите на исходный файл. Русский Excel и многие выгрузки из 1С пишут «;». Google Таблицы и зарубежные системы чаще ставят запятую. Если в результате один объект с одним длинным полем вместо набора ключей, разделитель неверный: смените его в CSV в JSON и повторите. Режим «Авто» обычно угадывает ;, , и таб.

Первая строка CSV это заголовки?

Да, для нормального массива объектов первая строка должна быть именами колонок. Именно они станут ключами в JSON. Если сверху лежит название отчёта или пустая строка, удалите её до конвертации. Без заголовков ключи получатся бесполезными для кода и схемы API.

Что делать с кодировкой Windows-1251?

При загрузке файла выберите Windows-1251 или оставьте «Авто», если инструмент его предлагает. Иначе кириллица в ключах и значениях превратится в кракозябры, и фикстура поедет в API уже битой. Если файл ломается ещё в Excel, сначала разберите кодировку через CSV в Excel и статью CSV в Excel без иероглифов.

Данные уходят на сервер при конвертации?

Нет. На Тулси конвертация CSV в JSON выполняется в браузере на вашем устройстве. Это удобно для черновых фикстур и локальных выгрузок. Если политика компании запрещает вставку любых таблиц во внешние страницы, используйте локальный скрипт в закрытом контуре.

Чем CSV в JSON отличается от JSON в CSV?

CSV в JSON собирает массив объектов из таблицы: заголовки → ключи, строки → объекты. JSON в CSV делает обратное: массив объектов превращает в табличный текст для Excel. Если старт это файл .csv или лист, идите в CSV в JSON. Если старт это ответ API в JSON, откройте JSON в CSV.

Почему в JSON одна строка вместо массива объектов?

Частая причина: неверный разделитель, и вся строка CSV читается как одно поле. Вторая: вы скопировали не весь файл или только одну строку без заголовков. Третья: исходник уже был JSON, и вы ждали повторную конвертацию из таблицы. Проверьте разделитель в CSV в JSON и сверьте число объектов с числом строк данных.

Нужен ли formatter после конвертации в JSON?

Если массив сразу валидный и ключи на месте, formatter не обязателен. Если парсер в коде ругается или вы правили результат руками, откройте JSON formatter и найдите обрыв скобок или лишнюю запятую. Formatter не заменяет конвертер: он читает и чинит структуру, а CSV→JSON как раз собирает массив из таблицы. Оба шага часто идут подряд перед тестом API.

Можно ли обойтись без Python для CSV в JSON?

Да, для разовой фикстуры или импорта хватает конвертера во вкладке браузера. Регистрация для обычной выгрузки не нужна. Скрипт на Python имеет смысл при ежедневном пайплайне и жёстких правилах типов. На Тулси страница CSV в JSON как раз для быстрого пути без установки.

Если после JSON нужна обратно таблица для Excel, откройте JSON в CSV. Для файла с иероглифами сначала CSV в Excel. Для проверки структуры результата откройте JSON formatter и разбор в статье как найти ошибку в структуре.