Идемпотентность
Все эндпоинты мутацийPOST и PATCH принимают необязательный заголовок Idempotency-Key.
Когда отправлять
Используйте ключ идемпотентности, когда:- Клиент может повторить запрос после сбоя транспорта.
- Обработчик очереди может отправить одну и ту же логическую операцию более одного раза.
- AI-агент может повторно выполнить мутацию после частичного прогресса или повторных попыток инструмента.
Рекомендуемый паттерн
- Генерируйте один стабильный ключ на одну логическую мутацию.
- Повторно используйте тот же ключ для повторов этой мутации.
- Меняйте ключ, когда меняется предполагаемая мутация.
Примеры
Правильные границы
- Один ключ для создания проекта.
- Другой ключ для экспорта этого проекта.
- И ещё один отдельный ключ для обновления настроек проекта.