Наиболее подходящий запрос Http

Question

Я разрабатываю приложение электронной почты. База данных содержит папки, содержащие электронные письма.

Скажите, что у меня есть электронное письмо в папке «Входящие», и я хочу переместить это письмо в корзину, что означает только изменение свойства электронной почты в FolderId.

Какой запрос Http является наиболее подходящим для такого типа операций?

У меня есть Http Post для создания нового сообщения электронной почты, но это кажется пустой тратой, чтобы принять POST для этой простой операции.

Благодаря

Answer 1

Какой Http запрос является наиболее подходящим для этого типа операции?

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

PUT /email/{id_of_message} HTTP/1.1 
Content-Type: application/json 

{ 
    "FolderId": "the trash folder id" 
} 

В качестве альтернативы вы можете использовать только DELETE глагол, если вы думаете, что будет лучше соответствовать семантику перемещения электронной ресурс в помойку:

DELETE /email/{id_of_message} HTTP/1.1 

Очевидно, что за кулисами реализация вашего метода выполняла одно и то же действие в обоих случаях: обновить свойство ресурса электронной почты, указанное идентификатором, предоставленным клиентом в сегменте пути запроса, FolderId.