Код состояния для конечной точки, которая создает, но не возвращает данные

#http #http-status-codes

#http #http-status-codes

Вопрос:

У меня есть и конечная точка из REST API, которая создает объект, но конечная точка не возвращает никаких данных.

Можно ли вернуть 201 код состояния? или было бы лучше вернуть 204 код состояния?

Какой из них выигрывает?

Ответ №1:

Код 201 состояния означает, что ресурс создан. Код 204 состояния не подходит для этой ситуации.

Ответ на запрос, который создает ресурс, должен содержать код 201 состояния и Location HTTP-заголовок с URI, который идентифицирует вновь созданный объект. Цитирую RFC 7231, текущую ссылку на семантику и содержимое протокола HTTP / 1.1:

6.3.2. 201 Создан

201 (Созданный) код состояния указывает, что запрос был выполнен и привел к созданию одного или нескольких новых ресурсов. Основной ресурс, созданный запросом, идентифицируется либо Location по полю заголовка в ответе, либо, если Location поле не получено, по действующему URI запроса. […]