Для AI-агентов: markdown этой страницы — /docs-content/partner-connect/keys.md индекс документации — /llms.txt

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

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

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

  • Код авторизации (code) действует 5 минут и одноразовый. После обмена через /v1/connect/token повторный вызов с тем же кодом вернёт invalid_grant.

  • Состояние согласия — внутреннее состояние страницы согласия — живёт 10 минут. Если пользователь не подтвердит за это время, ссылку придётся выдавать заново.

  • API-ключ не имеет срока истечения. Действует, пока его не отзовут. Отзыв происходит одним из четырёх способов:

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

    Деактивация клиента ключи НЕ отзывает — она только закрывает выдачу новых: с неактивным клиентом /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-ключи» кабинета Вайбкод или отзыв доступа приложению в профиле. При портальном потолке экран согласия предлагает выбрать тариф с большим лимитом ключей. Удаление ключей также освобождает место, если общее число действующих ключей портала становится ниже потолка.

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