Смена ключей

Смена секрета клиента и API-ключа

В панели есть одно действие для смены ключей, и оно заменяет оба ключа — secret и api_key — одновременно. Используйте его, если секрет утёк, или по расписанию, если этого требует ваша политика безопасности.

Приложение разработчика: в Мои приложения → приложение → Ключи нажмите Перевыпустить ключи и подтвердите кнопкой Перевыпустить.
Обычная кастомная интеграция: в окне интеграции нажмите Редактировать, затем в блоке Маркетплейс — Сменить secret → Всё равно сменить.

Новые секрет и API-ключ показываются там же один раз — скопируйте оба сразу (в разделе Ключи затем нажмите Я сохранил ключи). После обновления страницы или закрытия окна панель их больше не покажет.

Обе кнопки отправляют такой запрос.

Request

http

POST /admin/settings/integration/custom/regenerate-secret
Authorization: Bearer <your Bito session token>
Content-Type: application/json

{ "_id": "6712f0a9c4d1e87b3a0f1122" }

Response

json

{
    "code": 0,
    "message": "Success",
    "data": {
        "secret": "b81d47f2c095a6e3801fd2b7c46e9a35107fe2d84bc613905af7e28d1c60b493",
        "api_key": "acme:9f14c0f7a2b34d5e8c7190af2e5b6d3c",
        "secret_rotated_at": "2025-01-15T10:30:00.000Z",
        "api_key_rotated_at": "2025-01-15T10:30:00.000Z"
    },
    "time": "2025-01-15T10:30:00.000Z"
}

Сохраните и новый API-ключ, и новый секрет — старый ключ перестаёт работать сразу после ответа.

WARNING

Смена секрета отключает всех клиентов. В момент выдачи нового секрета:

все access-токены, выданные по старому секрету, перестают работать во всех аккаунтах, где установлена интеграция, а не только в вашем;
все refresh-токены перестают работать, потому что для обновления нужен текущий секрет;
токены виджета, подписанные старым секретом, больше не проходят проверку;
вебхуки данных и хуки установки/удаления во всех аккаунтах начинают подписываться новым секретом. Клиентам придётся подключиться заново. Планируйте смену секрета как работы с простоем: сначала выкатите новый секрет на свои серверы, только потом меняйте его в Bito.

Смена только API-ключа

Кнопки, которая меняет только API-ключ, в панели нет. Это можно сделать только через API: передайте regenerate_api_key: true в /admin/settings/integration/custom/update. Старый ключ перестаёт работать сразу, секрет не меняется.

INFO

Пока карточка на проверке (pending), custom/update — включая regenerate_api_key и изменение списка IP — отклоняется с ошибкой AlreadyInReview. Дождитесь решения модератора или отзовите карточку. На regenerate-secret это ограничение не распространяется.

Смена ключей ​

Смена секрета клиента и API-ключа ​

Смена только API-ключа ​

Смена ключей

Смена секрета клиента и API-ключа

Смена только API-ключа