Skip to content

Instantly share code, notes, and snippets.

@KRostyslav
Forked from zmts/PUTvsPOSTvsPATCH.md
Created January 30, 2018 19:10
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 1 You must be signed in to fork a gist
  • Save KRostyslav/72712b3a9e511134ce620ae21b29af09 to your computer and use it in GitHub Desktop.
Save KRostyslav/72712b3a9e511134ce620ae21b29af09 to your computer and use it in GitHub Desktop.
PUT or POST or PATCH?

PUT or POST or PATCH? PATCH!

TL;DR

POST для создания новых ресурсов
POST для остальных кастомных глаголов
PATCH для обновления ресурсов. В 99,99% на обновление уходят не все поля ('created_at' и 'updated_at' так точно)
На PUT можно забить =)

Идемпотентность

Идемпотентность это очень важный концепт в HTTP спецификации. Идемпотентный запрос - это запрос который независимо сколько раз эго отправит клиент, сервер вернет один и тот же ответ, без изменений. Другими словами, создание большого количества идентичных запросов имеет такой же эффект, как и один запрос. По HTTP спецификации GET, HEAD, PUT, и DELETE имеют этот атрибут, POST и PATCH - нет.

PUT подразумевает полное обновление независимо от того какие данные находятся по указанному URL, новыми данными. Исполюзуя PUT вы обязаны отправлять не только те поля которые вам необходимо а ВСЕ. Идемпотентность это фундаментальное свойство HTTP спецификации и должно соблюдаться для гаранрирования функциональной совместимости и масштабирования веба.

p.s.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment