JSON та XML в API

Вибір JSON чи XML в API потрібно розглядати в контексті контракту між програмою та API. Клієнт повинен розрізняти успішну відповідь, неправильні вхідні дані, помилку автентифікації, перевищення ліміту та тимчасову помилку сервера. Формат JSON або XML не змінює значення HTTP-кодів.

Як обробити відповідь API

Перевіряйте HTTP-код, Content-Type і документовані поля відповіді. Для 429 враховуйте Retry-After, якщо сервер його повертає, і не повторюйте запити безкінечно. Перед автоматичним повтором операції переконайтеся, що він не створить дубльовану дію.

Важлива деталь

JSON зазвичай компактний і природно відображається в об’єкти та масиви, а XML має атрибути, namespaces і зрілі schema-інструменти. Вибір залежить від контракту API та екосистеми, а не від універсального правила «цей формат швидший». Для реального запиту й актуального контракту API відкрийте API 2ip.