Методы HTTP: безопасное чтение и идемпотентность — разные свойства

Запросить

Фотография конкретного исполнения не приложена.

Safe method означает семантику, при которой клиент не запрашивает изменение состояния сервера. GET и HEAD относятся к этой группе. Это важно для автоматического обхода, предварительного получения и кэширования: ссылка, предназначенная для чтения, не должна скрыто выполнять технологическую команду только потому, что её открыл мониторинг.

Idempotent описывает другой признак: несколько одинаковых запросов имеют тот же предполагаемый эффект, что один. PUT и DELETE входят в эту группу наряду с safe methods. Это не означает одинаковый код ответа на каждом повторе и не запрещает отдельную запись каждого обращения в журнал.

Проект API должен явно задавать эти свойства для операций, а клиент — учитывать реальную семантику. Наличие слова POST не является автоматическим доказательством любой прикладной модели, но и произвольное повторение изменяющего запроса нельзя разрешать только по успеху сетевого соединения. Требование к идентичности операции определяют отдельно.

В приёмке проверяют согласованные чтения и изменения на тестовом ресурсе, включая повтор и журналирование. Сверяют запрошенный эффект и фактический результат. Одинаковый URL или одинаковое тело запроса не доказывают, что метод пригоден для безопасного фонового опроса либо обладает нужной идемпотентностью.

Основание — Selected IETF HTTP RFCs, exact numbered editions and sections cited, разделы RFC9110 §9.2.1 Safe Methods; §9.2.2 Idempotent Methods. Сохранён текст публичной справочной публикации; конкретная реализация может поддерживать только часть возможностей. Реальные зоны, resolver и HTTP-клиенты не испытывались. Это проектные критерии; номера RFC обозначают документы, а не подтверждённую поддержку всех возможностей конкретным устройством.

Все разборы