Коди статусу HTTP

Що пропонує сторінка «Коди статусу HTTP»

Коди статусу HTTP — це довідник із пошуком за кодами відповідей у діапазоні від 100 до 599. Він допомагає під час налагодження викликів API, написання документації, вибору відповіді для нового ендпоінта, читання журналів, перевірки поведінки шлюзу чи пояснення збою іншому розробнику. Кожен запис містить числовий код, фразу-пояснення, категорію та короткий опис того, що ця відповідь зазвичай означає. Фільтр зіставляє коди, назви, категорії та описи, тому можна шукати точні значення, як-от 404, широкі групи, як-от redirect, або поняття на кшталт cache, auth, proxy, timeout і валідація.

Список вбудовано безпосередньо в сторінку, а не завантажується із сервісу, тож він швидкий і доступний навіть тоді, коли ви працюєте офлайн або налагоджуєте мережеві проблеми. Клік по результату копіює код і фразу, що спрощує вставлення їх у коментарі до задач, документацію, тести чи нотатки про ендпоінти.

Приватна робота у браузері

Уся обробка відбувається у вашому браузері за допомогою клієнтського JavaScript. Інструмент не завантажує на сервер фрагменти, значення конфігурації, згенеровані дані, текст запитів чи скопійовані приклади й не вимагає облікового запису. Така суто локальна модель важлива для інструментів розробника, адже вставлений вміст часто нагадує реальні дані застосунку: відповіді API, журнали, зразки на кшталт змінних середовища, запити до бази даних, розмітку з чернеток або значення, скопійовані під час налагодження в продакшні. Локальна обробка знижує ризики та пришвидшує роботу, бо немає обміну даними через мережу.

Інтерфейс навмисно компактний: ви вставляєте вхідні дані, налаштовуєте параметри, перевіряєте результат, копіюєте його й повертаєтеся до редактора. Результати все одно слід перевіряти перед комітом, публікацією чи використанням у робочому процесі продакшну. Браузерні інструменти чудово підходять для швидкої перевірки й підготовки, але вони не знають усіх конвенцій проєкту, правил класифікації даних або вимог до валідації, специфічних для вашого застосунку.

Практичні поради

Коди статусу є частиною контракту API, тому обирайте їх свідомо. Використовуйте відповіді з сімейства 400, коли клієнт може змінити запит, з сімейства 500, коли сервер не зміг виконати коректний запит, і з сімейства 300, коли клієнту слід шукати ресурс деінде. Помилки автентифікації та авторизації часто плутають: 401 зазвичай означає, що автентифікація потрібна або недійсна, а 403 — що автентифікований користувач не має дозволу. Під час документування API поєднуйте код зі схемою тіла відповіді та порадами щодо усунення проблеми.