Как участнику получить свой API-ключ
Обновлено 24 октября 2026
Личный API-ключ позволяет участнику работать через программу с выданными ему папками. Ключ действует в выбранном пространстве и учитывает назначенные участнику права.
Это отдельный ключ участника. Ключи владельца находятся в «API / MCP»; передавать их коллеге для этой задачи не нужно.
Доступ зависит от тарифа пространства, в котором участник работает, и выданных ему прав. Отдельная платная подписка самому участнику не нужна. Чтобы пригласить нового коллегу, проверьте лимит мест в пространстве. Общий API сервиса доступен на всех текущих тарифах, но это другая возможность. Папки и действия личного ключа определяют разрешение владельца и роль участника. Возможности тарифов.
1. Владелец разрешает API-доступ
- Владелец или администратор с правом управления участниками открывает «Участники» → ⋮ возле участника → «Редактировать».
- Проверяет роль и выбирает в поле «Папки» доступные участнику папки.
- Включает «Доступ к API», при необходимости задаёт дату окончания и нажимает «Сохранить». Без даты разрешение действует до отзыва.
УвеличитьПри приглашении нового участника учитывается лимит участников пространства. Подробности приглашения и ролей описаны в инструкции о совместной работе. Включение переключателя ещё не создаёт ключ.
2. Участник создаёт свой ключ
- Примите приглашение и войдите под той почтой, на которую оно пришло. Выберите нужное рабочее пространство.
- Нажмите значок профиля → «Мой API-доступ». Проверьте название пространства и срок разрешения.
- Откройте создание ключа, задайте понятное имя, например «Учебный проект», и подтвердите создание.
- Скопируйте полный ключ сразу. Он показывается один раз. После закрытия окна в списке остаётся только его окончание.
УвеличитьУ каждого участника может быть один действующий ключ в одном пространстве. В списке видны имя, окончание ключа, дата создания, срок и последняя активность. Сам владелец секрет участника не видит.
3. Проверьте доступ к папкам
Начните с чтения списка папок. В Postman или своей программе отправьте запрос:
- Метод: GET.
- Адрес: https://api.webask.io/api/v3/service/folders.
- Заголовок: Authorization: Bearer YOUR_MEMBER_API_KEY. Замените заглушку своим ключом.
В ответе должны быть только папки, к которым участнику выдан доступ. Для работы с опросами используются методы API v3: чтение, создание, сохранение, публикация и чтение ответов. Каждое действие дополнительно проверяет роль: ключ сам по себе не открывает результаты и редактирование. Подробнее в документации по авторизации.
Ключ участника действует в одном пространстве и только в API v3. Он не подходит для MCP, старых API v1/v2, оплаты, управления участниками и других методов вне разрешённого набора. Запрос информации о пользователе GET /user этим ключом тоже закрыт.
По умолчанию для ключа участника доступно до 60 запросов в минуту, для всех ключей пространства вместе — до 600. При превышении лимита API возвращает ошибку 429 и время, через которое можно повторить запрос.
Если владелец изменит роль или доступные папки, следующие запросы начнут учитывать новые права. Ключ, созданный в кабинете, получает доступ ко всем папкам, выданным участнику, в том числе добавленным позже. В форме кабинета участник задаёт только имя ключа. Более узкие ограничения действий, папок и срока можно задать при создании через API; в форме кабинета отдельных полей для них нет.
4. Перевыпустите или отзовите ключ
В «Мой API-доступ» откройте меню ⋮ возле действующего ключа. Перевыпуск заменяет старый ключ новым: обновите его в своей программе. Отзыв прекращает работу старого ключа, а разрешение создать другой остаётся. Если срок ключа уже закончился, создайте новый.
Владелец может отдельно отозвать ключ в карточке участника или выключить «Доступ к API». Выключение доступа и удаление участника отзывают его ключи. Ключ не действует дольше срока, который разрешил владелец.
Храните ключ в защищённых настройках программы или переменной окружения. Не вставляйте его в адрес ссылки, код страницы, переписку или снимки экрана. Если полный ключ потерян или попал постороннему, перевыпустите его.
Если раздел или ключ недоступен
- Нет «Мой API-доступ»: проверьте выбранное пространство. В своём пространстве вы владелец и используете «API / MCP».
- Нет разрешения или закончился срок: попросите владельца проверить «Доступ к API» и дату в вашей карточке.
- Личный API недоступен по тарифу: в «Мой API-доступ» видно «В тарифе этого аккаунта нет API». Владелец проверяет тариф пространства. Для приглашения нового коллеги также должно хватать мест: на «Стандарте» их 3, на «Премиуме» — 5.
- Нет нужного опроса или ответов: владелец проверяет папки и роль. Разрешение на ключ не заменяет эти права.