# Время жизни, отзыв и лимит ключей

Сколько живут код авторизации и выданный API-ключ, кто и как отзывает ключ и сколько ключей может накопиться у одного пользователя на портале.

## Срок действия и отзыв

- **Код авторизации (`code`)** действует **5 минут** и одноразовый. После обмена через `/v1/connect/token` повторный вызов с тем же кодом вернёт `invalid_grant`.
- **Состояние согласия** — внутреннее состояние страницы согласия — живёт 10 минут. Если пользователь не подтвердит за это время, ссылку придётся выдавать заново.
- **API-ключ** не имеет срока истечения. Действует, пока его не отзовут. Отзыв происходит одним из четырёх способов:

  1. **Пользователь отзывает доступ сам** — раздел «Подключённые приложения» в его профиле Вайбкод. Это отзывает **все** ключи, которые он выдал вашему приложению для этого портала, включая ключи от прежних авторизаций. Доступы других сотрудников того же портала не затрагиваются.
  2. **Приложение отзывает свой ключ само** — [`POST /v1/connect/revoke`](/docs/partner-connect/revoke). Отзывается ровно один ключ, тот, который вы предъявили.
  3. **Платформенный администратор** отзывает выданные клиентом ключи.
  4. **Владелец приложения удаляет клиента полностью** — в [кабинете Connect](/connect-apps) сначала выберите «Деактивировать», затем в меню неактивного приложения — «Удалить полностью» и подтвердите действие. Все ключи этого клиента перестанут работать, а короткий адрес освободится. Восстановить удалённого клиента нельзя. Для официальных приложений полное удаление владельцем недоступно.

  **Деактивация клиента ключи НЕ отзывает** — она только закрывает выдачу новых: с неактивным клиентом `/v1/connect/authorize` отклонит запрос, а уже выданные ключи продолжат работать.

При отзыве ключа все запросы с ним возвращают `401 KEY_INACTIVE`. Если ключ удалён или неизвестен — `401 INVALID_API_KEY`. Партнёр должен корректно обработать оба кода и предложить пользователю повторно авторизоваться.

## Повторная авторизация выдаёт новый ключ

Каждое прохождение согласия выписывает **новый** API-ключ. Прежний ключ той же пары «пользователь и портал» при этом продолжает работать: авторизация не отзывает его. В профиле пользователя обе выдачи показаны одним подключением, и отзыв доступа отзывает их вместе.

Что из этого следует для приложения:

- Храните последний полученный ключ и заменяйте им предыдущий, иначе накопите рабочие ключи, о которых не помните.
- Каждая повторная авторизация занимает место в лимите ключей — см. ниже.
- Ключ, потерявший силу, восстановлению не подлежит: получите новый через `/v1/connect/authorize`.

## Лимит ключей

На одну пару «пользователь и портал» приходится не больше 100 действующих ключей — это и значение по умолчанию, и потолок настройки. Администратор портала может задать другое значение, от 1 до 100. В счёт идут ключи пользователя на этом портале от всех приложений, а не только выданные вашим. Ключи настольного приложения Коворк/Код место не занимают.

Кроме пользовательского лимита у портала без коммерческого тарифа есть портальный потолок платформы — он считается по всем живым ключам портала и не поднимается администратором портала. Когда один из пределов исчерпан, выдача отклоняется кодом `KEY_LIMIT_REACHED`: пользователь видит причину на странице согласия, а приложение получает только этот код в `error_description` при возврате на `redirect_uri`. Для пользовательского лимита место освобождает удаление ненужных ключей в разделе [«API-ключи»](/keys) кабинета Вайбкод или отзыв доступа приложению в профиле. При портальном потолке экран согласия предлагает выбрать тариф с большим лимитом ключей. Удаление ключей также освобождает место, если общее число действующих ключей портала становится ниже потолка.

## Смотрите также

- [Отозвать ключ приложением](/docs/partner-connect/revoke)
- [Обменять код на API-ключ](/docs/partner-connect/token)
- [Partner Connect](/docs/partner-connect)
