Рекомендации по REST API: куда следует передавать данные в запросах POST? Параметры, Конечная точка, Тело?

Question

Я знаю, что это довольно общий вопрос, но я искал вокруг и не могу найти какие-либо рекомендации или рекомендации по разработке API, специально предназначенные для приема данных в POST / PUT запросах.

Итак, каковы наилучшие методы, которым нужно следовать при разработке вашего API, и есть ли какие-либо правила или рекомендации, которым вы следуете?

Спасибо!

Answer 1

Обычно, когда данные отправляются на HTTP-сервер, соответствующие данные, относящиеся к тому, что вы публикуете, будут в теле.

Обычно я говорю, потому что есть исключения.

Это тем более в случае с PUT, данные действительно должны быть в теле. Если в запросе PUT нет тела, значение запроса: «пожалуйста, замените этот ресурс на 0-байтовый ресурс».