---
title: "Что такое ключ идемпотентности? Безопасные повторы в API"
description: "Ключ идемпотентности — уникальный ID, который клиент шлёт с запросом, чтобы повтор не сработал дважды, как второе списание. Как это работает и заголовок IETF."
url: https://broadrouter.com/ru/glossary/idempotency-key/
lang: ru
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Переведено с английского с помощью ИИ. [Читать оригинал на английском](https://broadrouter.com/glossary/idempotency-key/) (обновлён 2026-11-14).

# Ключ идемпотентности (idempotency key)

Обновлено 2026-11-14

Ключ идемпотентности — это уникальное значение, обычно случайный ID вроде UUID, которое клиент прикладывает к запросу, меняющему состояние, например к платежу или покупке. Если тот же запрос приходит снова с тем же ключом, сервер возвращает исходный результат, а не выполняет действие второй раз.

Также называют: ключ идемпотентности, идемпотентный запрос, идемпотентность API, идемпотентный повтор, заголовок Idempotency-Key, idempotency key, Idempotency-Key header, idempotency token, idempotent request, idempotent retry

Сеть подводит в самый неудачный момент: когда сервер уже выполнил действие, а ответ до вас не дошёл. Ключ идемпотентности делает повтор безопасным.

## Как это работает

Клиент создаёт уникальный ключ для одного задуманного действия и отправляет его вместе с запросом. Сервер сохраняет ключ вместе с результатом. Если тот же ключ приходит снова, сервер возвращает сохранённый результат вместо того, чтобы выполнять действие ещё раз.

Рабочая группа IETF HTTPAPI стандартизирует это как заголовок запроса `Idempotency-Key` (черновик 08, октябрь 2026 года, пока не RFC). Ключ описан в нём как “a unique value generated by the client which the resource uses to recognize subsequent retries of the same request” (перевод: «уникальное значение, сгенерированное клиентом, по которому ресурс распознаёт последующие повторы того же запроса»), а в качестве ключа рекомендуется UUID или похожий случайный ID. Ошибочные случаи по черновику:

| Ситуация | Статус |
| --- | --- |
| Ключ отсутствует, хотя обязателен | 400 Bad Request |
| Исходный запрос ещё выполняется | 409 Conflict |
| Ключ повторно использован с другим телом | 422 Unprocessable Content |

AWS Builders’ Library говорит то же самое со стороны клиента: “APIs with side effects aren’t safe to retry unless they provide idempotency.” (перевод: «API с побочными эффектами небезопасно вызывать повторно, если они не обеспечивают идемпотентность».)

## Почему это важно

Повторы с [экспоненциальной задержкой](https://broadrouter.com/ru/glossary/exponential-backoff/) — стандартная практика, и многие SDK повторяют запросы автоматически. Без идемпотентности повтор после тайм-аута может создать два заказа или два списания. С ключом повтор безопасен, что бы ни сделала первая попытка. Поэтому это базовый инструмент для агентов и скриптов, которые покупают, бронируют или создают что-то без присмотра человека.

## В BroadNet Inference

BroadNet применяет этот подход при покупке [почасовых ключей](https://broadrouter.com/ru/blog/hourly-llm-api-key-explained/). `POST /portal/keys/hourly` принимает `request_id` в JSON-теле, а документация утверждает: “Idempotency is required for money safety” (перевод: «Идемпотентность обязательна для финансовой безопасности»):

```bash
curl -X POST https://inference.broadnet.ai/portal/keys/hourly \
  -H "Authorization: Bearer <portal-credential>" \
  -H "Content-Type: application/json" \
  -d '{"request_id":"order-20260920-001","label":"kiosk-1"}'
```

Повторное использование `request_id` не создаёт ещё один ключ и не списывает за него деньги. После тайм-аута, обрыва соединения, ответа 409 `mint_in_progress` или 5xx повторяйте запрос с тем же `request_id`. Повторный ответ вернёт `already_issued: true` и алиас ключа; сам ключ в открытом виде есть только в первом успешном ответе. В документации сказано: “Never generate a replacement id until the original result is known.” (перевод: «Никогда не генерируйте новый id, пока не известен результат исходного запроса».)

BroadNet не описывает ключ идемпотентности для `/v1/chat/completions` и транскрибации. Что там стоит повторять, смотрите в руководстве [коды ошибок и повторы](https://broadrouter.com/ru/guides/errors-and-retries/), а почему слепые повторы могут усугубить 429 — в статье о [лимитах запросов](https://broadrouter.com/ru/glossary/rate-limit/).

## Вопросы и ответы

### Когда нужно генерировать новый ключ идемпотентности?

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

### Нужен ли ключ идемпотентности для запросов chat completions к LLM?

Генерация текста не оставляет долговременных побочных эффектов, поэтому повторный чат-запрос обычно просто снова тратит токены. Ключ важен для вызовов, которые списывают деньги или создают ресурсы. BroadNet описывает его только для покупки почасовых ключей, а не для chat completions.

### Что будет, если повторно использовать ключ с другим телом запроса?

По черновику IETF сервер должен отклонить такой запрос с кодом 422 Unprocessable Content, потому что ключ уже привязан к другому запросу.

## См. также

-   [Экспоненциальная задержка (exponential backoff)](https://broadrouter.com/ru/glossary/exponential-backoff/) (термин)
-   [Лимит запросов (rate limit)](https://broadrouter.com/ru/glossary/rate-limit/) (термин)
-   [API-ключ (API key)](https://broadrouter.com/ru/glossary/api-key/) (термин)
-   [Параллельность (concurrency)](https://broadrouter.com/ru/glossary/concurrency/) (термин)
-   [Коды ошибок BroadNet Inference и когда повторять запрос](https://broadrouter.com/ru/guides/errors-and-retries/) (руководство)
-   [Привязка API-ключей к серверам через белый список IP](https://broadrouter.com/ru/guides/api-keys-ip-allow-lists/) (руководство)
-   [Долгоживущие ИИ-агенты: таймауты, повторы и чекпойнты](https://broadrouter.com/ru/blog/long-running-agents-timeouts-retries/) (статья)
-   [Почасовой ключ LLM API: фиксированная цена за час](https://broadrouter.com/ru/blog/hourly-llm-api-key-explained/) (статья)

Проверьте на своей реальной нагрузке. Новые аккаунты получают стартовый грант US$5 на Gemma и распознавание речи. Для DeepSeek, GLM и Qwen3.8 нужно пополнить баланс.

[Начать](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-glossary-idempotency-key&utm_content=page-cta) ·

**Источники**

-   [IETF HTTPAPI, The Idempotency-Key HTTP Header Field (Internet-Draft)](https://datatracker.ietf.org/doc/draft-ietf-httpapi-idempotency-key-header/)
-   [AWS Builders' Library, Timeouts, retries and backoff with jitter (токены идемпотентности)](https://builder.aws.com/content/3EumjoZascWd1oZiEgL8ORlv3qE/timeouts-retries-and-backoff-with-jitter)
-   [Справочник API BroadNet Inference, почасовые ключи (идемпотентность через request\_id) (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-glossary-idempotency-key&utm_content=sources#hourly-keys)
