Ключевая теория, которую подробно разобрали вебинаре
Методы REST API и их назначение
🟢 GET
Получение объектов данных, формируемых из БД системы
🟢 POST
Создание новых объектов данных в БД.
Получение данных в исключительных случаях (асинхронное получение данных, размещение запроса на обработку транзакции - отчеты, получение большой выборки данных, работа с агрегаторами)
🟢 PUT
Создание или изменение данных об объекте в БД. Важно! При изменении данных требуется полный объект для его перезаписи.
Пример: для изменения паспортных данных, даже если поменялся только номер паспорта и дата выдачи, все равно придется передавать все его параметры, включая ФИО, дату рождения владельца, пол и т.д.
🟢 PATCH
Частичное изменение данных в БД
Пример: для изменения паспортных данных, если нужно поменять только номер паспорта и дату выдачи, то передаем только их в запросе PATCH и ничего более. Через один и тот же метод PATCH можно каждый раз передавать только те поля к изменению, которые нужно
🟢 DELETE
Удаление данных в БД, либо установка флага "скрыть" (is_visible=false), чтобы при получении не возвращать пользователю.
OPTIONS, HEAD, TRACE и другие методы почти не используются, т.к. хватает перечисленных.
Методы REST API и их назначение
🟢 GET
Получение объектов данных, формируемых из БД системы
🟢 POST
Создание новых объектов данных в БД.
Получение данных в исключительных случаях (асинхронное получение данных, размещение запроса на обработку транзакции - отчеты, получение большой выборки данных, работа с агрегаторами)
🟢 PUT
Создание или изменение данных об объекте в БД. Важно! При изменении данных требуется полный объект для его перезаписи.
Пример: для изменения паспортных данных, даже если поменялся только номер паспорта и дата выдачи, все равно придется передавать все его параметры, включая ФИО, дату рождения владельца, пол и т.д.
🟢 PATCH
Частичное изменение данных в БД
Пример: для изменения паспортных данных, если нужно поменять только номер паспорта и дату выдачи, то передаем только их в запросе PATCH и ничего более. Через один и тот же метод PATCH можно каждый раз передавать только те поля к изменению, которые нужно
🟢 DELETE
Удаление данных в БД, либо установка флага "скрыть" (is_visible=false), чтобы при получении не возвращать пользователю.
OPTIONS, HEAD, TRACE и другие методы почти не используются, т.к. хватает перечисленных.