По какому стандарту вы описывали REST API? Как сделать POST идемпотентным?

Часто для описания REST API используют стандарт OpenAPI (ранее известный как Swagger). Он позволяет формализовать описание API в формате YAML или JSON, что облегчает генерацию документации, клиентских SDK и тестирование.

Чтобы сделать POST идемпотентным, можно использовать несколько подходов:

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

Пример с Idempotency-Key:

POST /orders HTTP/1.1
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json

{ "product_id": 42, "quantity": 1 }

Если сервер получил такой запрос ранее с этим ключом, он вернёт тот же ответ, не создавая новый заказ.