Идемпотентность глагола GET в RESTful API

Идемпотентность — это обещание клиентам/посредникам, что запрос может быть повторен в случае сетевых сбоев или тому подобного без каких-либо дополнительных соображений и не столько в том, что данные никогда не изменятся.

Например, если вы возьмете запрос POST, в случае сбоя сети вы не знаете, достиг ли сервер предыдущего запроса, но ответ был потерян на полпути или первоначальный запрос вообще не достиг сервера. Если вы повторно отправите запрос, вы можете фактически создать дополнительный ресурс, поэтому POST не является идемпотентным. PUT с другой стороны имеет контракт, который заменяет текущее представление тем, которое содержится в запросе. Если вы отправляете один и тот же запрос дважды, содержимое ресурса должно быть одинаковым после обработки любого из двух PUT запросов. Обратите внимание, что фактический результат все еще может отличаться, поскольку служба может изменить полученный объект в соответствующее представление. Кроме того, между отправкой данных через PUT и их получением через GET еще один клиент мог обновить состояние между ними, поэтому нет гарантии, что вы действительно получите точное представление, которое вы отправили в службу.

Безопасность — еще одно обещание, которое поддерживают только GET, HEAD и OPTIONS. Он обещает инициатору, что он вообще не изменит какое-либо состояние, поэтому клиенты/посредники могут безопасно выдавать такой запрос, не опасаясь, что он изменит какое-либо состояние. На практике это важное обещание сканерам, которые вслепую обращаются к любым URL-адресам, чтобы изучить их содержимое. В случае нарушения таких обещаний, т. е. путем удаления данных при обработке GET запроса, виноват только разработчик сервиса, а не инициатор. Если сканер вызывает такие URL-адреса и, следовательно, удаляет некоторые данные, на самом деле это не ошибка сканеров, а только разработчик службы.

Поскольку у вас есть динамическое значение в вашем ответе, вы можете захотеть предотвратить кеширование ответов, хотя в противном случае посредники могут вернуть старое состояние для вашего ресурса.