Блок 3 · Урок 2 из 4

JSON — формат обмена данными

Общий язык, на котором фронтенд, бэкенд и чужие API передают друг другу данные; и почему уметь его читать — это ваш инструмент приёмки.

⏱ ≈ 7 минут 📄 язык данных 🎯 цель: читать ответ API и проверять, что в нём нужные поля

Зачем это вам

Когда агент показывает «вот что вернул API» — это JSON. Умея прочитать JSON, вы проверяете приёмку: пришли ли нужные поля, правильные ли значения, не null ли там, где ждёте данные. Это превращает вас из «верю на слово» в «вижу сам» — и делает ваши правки точнее, а баги очевиднее.

Что такое JSON

Текстовый формат, который понимают все программы

JSON (JavaScript Object Notation — «запись объекта на JavaScript») — простой текстовый формат обмена данными между программами.1 Он человекочитаемый, но предназначен прежде всего для машин. Почти все API отвечают именно в JSON.2

Основная единица — объект в фигурных скобках { }: набор пар «ключ: значение». Ключи — всегда строки в двойных кавычках. Значение может быть одного из шести типов:1 строка в кавычках, число, true или false, null (пусто/отсутствует), массив [ ] (упорядоченный список) и вложенный объект { }.

{
  "name": "Анна",
  "age": 30,
  "active": true,
  "hobbies": ["чтение", "бег"],
  "address": { "city": "Москва" }
}

Читаем по примеру: ключи слева от двоеточия — "name", "age" и т. д. Значения справа. "hobbies" — массив: несколько значений в квадратных скобках через запятую. "address" — вложенный объект: у него внутри свои пары «ключ: значение».

📌 Практическое правило. Открыли ответ API — ищите нужные ключи и проверяйте их значения. Пусто на экране чаще всего означает: поле пришло пустым, равно null или называется иначе, чем ожидал разработчик.

Аналогия, которую можно пересказать

Заполненная анкета

JSON — как анкета с подписанными полями: «Имя: Анна», «Возраст: 30», «Хобби: [чтение, бег]». Кто знает формат анкеты, поймёт её одинаково — и человек, и программа.

Анкета целиком— JSON-объект { }
Подпись поля— ключ ("name")
Вписанное значение— значение ("Анна", 30, true)
Раздел внутри анкеты— вложенный объект { }
Поле с несколькими ответами— массив [ ]

Единый формат подписей делает данные понятными любой программе без дополнительных объяснений.

Запомните одно

JSON — общий «язык анкет» интернета

Раз почти все API отвечают на нём, умение прочитать JSON = умение принять работу: вы видите сами, что вернул сервер, не полагаясь только на слова агента.

Что это даёт на практике

Фраза агента → что он имеет в виду

«API вернул JSON»
Данные пришли в этом формате — можно открыть и прочитать поля.
«Распарсим ответ»
Превратим JSON-текст в объект, чтобы достать нужные поля. Парсинг — разбор текста в данные.
«Поле приходит null»
Значение пустое или отсутствует — частая причина того, что на экране ничего нет.
«Сериализуем в JSON»
Превратим наши данные в JSON-текст, чтобы отправить другой программе. Сериализация — упаковка данных в текст.

JSON (JavaScript Object Notation) — текстовый формат обмена данными: пары «ключ: значение», списки и вложенность.

Ключ и значение — «подпись поля» и его содержимое; в JSON ключи всегда в двойных кавычках.

Массив (array) — упорядоченный список значений в квадратных скобках [ ].

Парсинг (parse) — превращение JSON-текста в объект, с которым работает программа.

Проверьте себя

Четыре вопроса с мгновенной проверкой

1. Что такое JSON?

2. Как в JSON записывается пара «ключ — значение»?

3. Что означают квадратные скобки [ ] в JSON?

4. Агент говорит: «нужное поле приходит null». Что это означает?

Куда мы идём

Программа курса — 7 блоков