Перейти к основному содержимому

Лимит расходов по API-ключу

Установить лимит расходов для API-ключа можно как при его создании, так и в дальнейшем при редактировании. Настройка лимитов доступна в разделе API-ключи.

Лимит расходов реализован по принципу Token Bucket. Он определяет скорость возобновления доступного остатка и его максимальный размер.

Например, лимит 24 000 ₽ в день означает, что:

  • если доступный остаток меньше лимита, он восполняется непрерывно и равномерно со скоростью 1 000 ₽ в час (~16 ₽ в минуту), пока не сравняется с лимитом;
  • если доступный остаток равен 0 (лимит полностью израсходован), через минуту станет доступно ~16 ₽, через полчаса 500 ₽ и т. д.
предупреждение

Фактически за выбранный период может быть потрачена двойная сумма.

Предположим, текущий доступный остаток равен лимиту — 24 000 ₽. Такое возможно, например, если за предыдущие 24 часа не было расходов.

  1. Эти 24 000 ₽ можно потратить очень быстро, даже за минуту.
  2. Доступный остаток тут же начнет пополняться со скоростью ~16 ₽ в минуту, 1 000 ₽ в час. Эти деньги тоже можно тратить. За 24 часа добавится 24 000 ₽ — значит, за это время можно потратить еще 24 000 ₽.

В этом случае за сутки будет израсходовано:

  • 24 000 ₽ — первоначальный доступный остаток;
  • еще 24 000 ₽, которые постепенно становятся доступны в течение 24 часов после того, как первоначальный доступный остаток полностью израсходован.

Чтобы обеспечить более равномерное распределение затрат, установите несколько лимитов, например на час, на день и на месяц.

Как работает опция «Новый лимит доступен сразу»​

Опция Новый лимит доступен сразу влияет на доступный остаток при увеличении лимита расходов или добавлении нового лимита расходов.

Если опция включена:

  • При увеличении лимита мгновенно увеличится доступный остаток. Например, если лимит в час изменить с 1 000 ₽ до 1 200 ₽, то остаток тоже возрастет на 200 ₽.
  • Новый лимит полностью доступен с момента создания. Например, сумма дневного лимита может быть израсходована в первые минуты.

Если опция выключена:

  • В момент увеличения лимита доступный остаток не меняется, возрастает только скорость восполнения.
  • Новый лимит создается с нулевым доступным остатком.