API та інтеграції

Що таке JSON?

JSON (JavaScript Object Notation) — це текстовий формат обміну даними, у якому інформацію записують парами «ключ — значення». Його розуміють усі мови програмування, і саме в ньому найчастіше відповідають сучасні API.

Структура проста: об’єкти записують у фігурних дужках, списки — у квадратних, а значеннями можуть бути рядки, числа, логічні значення або вкладені об’єкти. JSON зручно читати людині, і програма легко його розбирає без додаткових описів.

JSON замінив XML як основний формат для вебAPI: він компактніший, простіший і легко перетворюється на структури даних у коді. В AI-розробці в JSON модель повертає виклики інструментів під час function calling.

Де застосовується

JSON використовують не лише в API. У ньому зберігають налаштування проєктів — package.json у Node.js, tsconfig.json, composer.json, — пишуть структуровані логи, описують конфігурації інфраструктури і передають дані між мікросервісами.

Бази даних підтримують JSON як повноцінний тип: PostgreSQL і MySQL зберігають його в колонці і шукають за окремими полями всередині. У роботі з мовними моделями JSON — головний спосіб отримати від моделі відповідь, яку зможе обробити програма.

Приклад

Відповідь API на запит одного замовлення може виглядати так: номер замовлення, статус оплати, сума, дані клієнта і список товарів.

{
  "order_id": "A-10427",
  "paid": true,
  "total": 4900,
  "customer": {
    "name": "Анна",
    "city": "Київ"
  },
  "items": [
    { "sku": "JV-01", "qty": 1 },
    { "sku": "PY-07", "qty": 2 }
  ]
}

Об’єкт із вкладеним об’єктом і списком — типова відповідь API.

Часті запитання

Чим JSON відрізняється від XML?

XML описує дані тегами, підтримує атрибути, схеми і простори імен — він потужніший, але більш громіздкий. JSON компактніший, легше читається і прямо відповідає об’єктам та масивам у коді. Тому вебAPI майже повністю перейшли на JSON.

Чи можна писати коментарі в JSON?

У стандартному JSON коментарів немає, і сувора перевірка видасть помилку. Це обходять по-різному: додають поле на кшталт _comment, переносять налаштування в YAML, де коментарі є, або використовують формат JSONC, який розуміють редактори коду, але не API.

Чим JSON відрізняється від об’єкта JavaScript?

JSON — це текст, а об’єкт JavaScript — структура в пам’яті програми. У JSON ключі завжди в подвійних лапках, і в ньому не можна зберігати функції, дати чи undefined. Для перетворення між ними використовують JSON.parse і JSON.stringify.

Що таке JSON Schema?

Це опис того, яким має бути документ: які поля обов’язкові, якого вони типу, які значення допустимі. За схемою автоматично перевіряють вхідні дані і створюють документацію. Тим самим способом описують інструменти, які викликає мовна модель.

Навчання програмуванню в OWU

Опануйте професію в IT на практичних курсах із менторами та реальними проєктами.

Обрати курс