Для AI-агентов: markdown этой страницы — /docs-content/partner-connect/keys.md индекс документации — /llms.txt
Время жизни, отзыв и лимит ключей
Сколько живут код авторизации и выданный API-ключ, кто и как отзывает ключ и сколько ключей может накопиться у одного пользователя на портале.
Срок действия и отзыв
Код авторизации (
code) действует 5 минут и одноразовый. После обмена через/v1/connect/tokenповторный вызов с тем же кодом вернётinvalid_grant.Состояние согласия — внутреннее состояние страницы согласия — живёт 10 минут. Если пользователь не подтвердит за это время, ссылку придётся выдавать заново.
API-ключ не имеет срока истечения. Действует, пока его не отзовут. Отзыв происходит одним из четырёх способов:
- Пользователь отзывает доступ сам — раздел «Подключённые приложения» в его профиле Вайбкод. Это отзывает все ключи, которые он выдал вашему приложению для этого портала, включая ключи от прежних авторизаций. Доступы других сотрудников того же портала не затрагиваются.
- Приложение отзывает свой ключ само —
POST /v1/connect/revoke. Отзывается ровно один ключ, тот, который вы предъявили. - Платформенный администратор отзывает выданные клиентом ключи.
- Владелец приложения удаляет клиента полностью — в кабинете 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-ключи» кабинета Вайбкод или отзыв доступа приложению в профиле. При портальном потолке экран согласия предлагает выбрать тариф с большим лимитом ключей. Удаление ключей также освобождает место, если общее число действующих ключей портала становится ниже потолка.