JSON в CSV

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

JSON — это то, что вам отдаёт API; CSV — то, что откроет таблица. Переход от одного к другому — постоянная мелкая рутина, и обычно её делают, вставляя данные на первый попавшийся сайт, а в этих данных регулярно бывают имена клиентов, адреса электронной почты и сведения о заказах. Здесь конвертация идёт на странице, так что данные остаются у вас.

Какую форму он ожидает

Массив объектов — это обычно возвращает конечная точка со списком. Заголовки столбцов берутся из ключей, собранных по всем записям, так что строки с отсутствующими полями всё равно выравниваются правильно. Один объект обрабатывается как таблица из одной строки.

Кавычки обрабатываются правильно

Значения с запятыми, кавычками или переносами строк заключаются в кавычки и экранируются внутри — по тому же соглашению, которого ожидают таблицы. Именно здесь самодельные конвертеры почти всегда ошибаются, и именно поэтому столбец с адресами так часто ломает CSV.

Вложенные значения

Значение, которое само является объектом или массивом, записывается в ячейку как текст JSON, потому что CSV плоский и больше ему некуда это поместить. Если эти поля важны, сначала разверните структуру в плоскую.

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

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