Практичний приклад
Відповідь API {"price":"19.90","active":"false"} є правильним JSON, але число й логічне значення в лапках можуть зламати клієнт, який очікує строгі типи.
JSON (JavaScript Object Notation) — легкий текстовий формат для обміну структурованими даними між сервісами та застосунками.
Інструмент форматує JSON для зручного читання або мініфікує його для зберігання й передавання мережею. Обробка відбувається локально у браузері.
Зробіть JSON читабельним, щоб легко перевірити вкладені масиви, об’єкти, значення null та екрановані рядки.
Синтаксично правильний JSON усе одно може не відповідати контракту API. Перевірте обов’язкові поля, типи та допустимі значення за схемою.
Якщо форматування не вдається, переконайтеся, що відповідь справді містить JSON, а не HTML-сторінку помилки, обрізані дані чи запис журналу.
Мініфікований JSON зручний для передавання та конфігураційних файлів, але під час налагодження працюйте з відформатованою версією.
Дізнайся workflow за цим інструментом і що перевіряти далі.
Послідовний процес, що відокремлює транспортні помилки, синтаксис JSON і невідповідність контракту даних.
Практичний workflow для форматування JSON, пошуку syntax errors, перевірки payload shape і response status, коли API data виглядає неправильно.
Форматування — лише перший крок. Перевірте структуру, типи й вкладеність даних, а також приберіть приватну інформацію перед додаванням відповіді до тестів або документації.
Знайдіть пропущені або зайві коми, неекрановані лапки, дублікати полів і надто глибоко вкладені масиви.
Шукайте рядки замість чисел, null там, де застосунок його не обробляє, і логічні значення, передані як текст.
Мініфікуйте JSON для компактних тестових даних або форматуйте його для перевірки коду, звітів про помилки й документації API.
Замініть токени, електронні адреси, ідентифікатори клієнтів і реальні записи безпечними прикладами, перш ніж поширювати JSON.
Відповідь API {"price":"19.90","active":"false"} є правильним JSON, але число й логічне значення в лапках можуть зламати клієнт, який очікує строгі типи.
Відповідь, що починається з <html>, зазвичай є сторінкою помилки проксі або застосунку, а не пошкодженим JSON. Спочатку перевірте HTTP-статус і Content-Type.
Я використовую форматування, щоб побачити структуру, а контракт даних перевіряю окремо: читабельний JSON не обов’язково є правильним для API.
Можливо, тобі також стануть у пригоді ці інструменти.