Как реализовать идемпотентный POST, чтобы он не был по семантике идентичен PUT?

Идемпотентность POST можно реализовать через использование уникального идентификатора запроса (например, Idempotency-Key), который клиент генерирует и отправляет вместе с запросом. Сервер сохраняет этот ключ и результат обработки запроса. Если приходит повторный запрос с тем же ключом, сервер возвращает тот же ответ, не создавая новый ресурс.

Это отличается от PUT, который по семантике обновляет или создает ресурс по известному URI, а POST обычно создаёт ресурс с серверно-сгенерированным идентификатором.

Пример:

• Клиент отправляет POST с Idempotency-Key: 12345 для создания заказа.
• Сервер создаёт заказ и сохраняет результат с ключом 12345.
• При повторном запросе с тем же ключом сервер возвращает уже созданный заказ, не создавая новый.

Таким образом, POST остаётся семантически созданием ресурса, но становится идемпотентным за счёт ключа, а не превращается в PUT, который обновляет ресурс по известному URI.