HTTP-статуси 200 vs 201 у чому різниця

У розробці REST API правильний вибір кодів відповідей HTTP є критично важливим для побудови зрозумілої та надійної архітектури. Двома найпопулярнішими успішними статусами є 200 OK та 201 Created. Попри схожість, вони мають чітке семантичне розмежування.

200 OK: Загальний успіх

Статус 200 OK — це універсальна відповідь, яка свідчить про те, що сервер успішно обробив запит і повертає очікуваний результат.

Коли використовувати 200 OK

• GET: Запит повернув запитувані дані.
• PUT / PATCH: Існуючий ресурс успішно оновлено.
• DELETE: Ресурс видалено (якщо сервер повертає опис статусу або старий об'єкт).

У тілі такої відповіді зазвичай містяться дані (JSON, XML або HTML-сторінка), які запитував клієнт.

201 Created: Народження нового ресурсу

Статус 201 Created використовується виключно тоді, коли в результаті запиту на сервері фізично з'явився новий ресурс (новий рядок у базі даних, новий файл тощо).

Коли використовувати 201 Created

• POST: Створення нового об'єкта (наприклад, реєстрація користувача, додавання товару в кошик).
• PUT: Створення об'єкта за конкретною URL-адресою, якщо його там раніше не існувало.

Тіло відповіді 201 може містити копію створеного об'єкта з його новим ID або коротке повідомлення про успіх.

Таємна зброя: Заголовок Location

Головна технічна відмінність статусу 201 Created від 200 OK згідно зі специфікацією HTTP (RFC 7231) — це рекомендація (а часто й вимога) додавати заголовок відповіді Location.

Заголовок Location — це стандартний HTTP-заголовок, який містить абсолютний або відносний URL щойно створеного ресурсу.

Навіщо він потрібен?

Коли фронтенд або мобільний додаток відправляє запит на створення об'єкта, йому потрібно знати, де цей об'єкт тепер знаходиться, щоб:

1. Одразу зробити туди GET-запит і показати користувачу нову сторінку.
2. Зберегти посилання для подальших оновлень чи видалення.