Формат JSON для API и структурированных выгрузок
Универсальный формат для обмена вложенными данными, карточками объектов и интеграций между приложениями.
Когда использовать JSON
JSON хорошо подходит для API, отдельных карточек тендеров, контрактов, организаций и документов. Он сохраняет вложенные массивы и объекты, поэтому структуру не приходится искусственно уплощать.
Для массовой поставки миллионов записей обычный JSON-массив менее удобен: файл нужно целиком разбирать и хранить в памяти. В таких случаях лучше JSONL или Parquet.
JSON используется в API TenderGuru и может применяться в небольших выборках, конфигурациях и связанных объектах.
Параметры запросов, названия полей и полная структура ответов опубликованы в документации API TenderGuru.
Открыть документацию APIСильные стороны
- сохраняет вложенную структуру
- легко читается большинством языков
- удобен для API и карточек
- подходит для отладки
Что учитывать
- не оптимален для очень больших файлов
- меньше сжатие и скорость аналитики, чем у Parquet
- схему необходимо контролировать на стороне клиента
Вопросы о формате JSON
Для каких объемов подходит JSON?
Подходящий объем зависит от структуры и инструмента обработки. Для API и отдельных карточек удобен JSON, для потоковых файлов — JSONL, для большой аналитики — Parquet, для простых таблиц — CSV.
Можно ли получить одну и ту же базу в нескольких форматах?
Да. При согласовании поставки можно подготовить основной формат и дополнительный демонстрационный или совместимый формат.
Как передаются вложенные массивы и связанные сущности?
В JSON и JSONL они могут оставаться вложенными. В CSV и Parquet связанные сущности часто передаются отдельными таблицами со стабильными ключами.
Можно ли изменить названия и типы полей?
Для индивидуальной поставки можно согласовать схему, названия полей, типы дат, представление NULL и правила нормализации.
Где посмотреть структуру API?
Полная структура и параметры методов опубликованы в документации API TenderGuru.