API кабинета: ключ и основные адреса

Тот же ключ, что для MCP; JSON-ответы кабинета по HTTP

Обновлено 19 сентября 2026 г. API 2 мин чтения

Всё, что делает кабинет, доступно по HTTP с тем же ключом, что и MCP. Ключ создаётся в «Аккаунт» → «Ключи API и MCP» и передаётся заголовком Authorization: Bearer wv_… или X-Api-Key: wv_…. Ответы — JSON; ошибки — объект {error} с кодом 4xx.

bash

curl -H "Authorization: Bearer wv_ВАШ_КЛЮЧ" https://woove.ru/api/me

Адреса чтения

Адрес	Что возвращает
`GET /api/me`	`account`, `billing_ready` — кто вы и включена ли оплата
`GET /api/account`	`account`, `totals`, `daily`, `services` — сводка аккаунта и заявки по дням
`GET /api/site/projects`	`projects`, `plan` — сайты Woove Site и тариф
`GET /api/site/leads`	`leads` — заявки с форм сайтов
`GET /api/site/bookings`	`bookings` — записи через блок «Онлайн-запись»
`GET /api/site/media`	`media` — файлы медиатеки
`GET /api/kb`	`kbs`, `sub`, `host` — базы знаний и подписка
`GET /api/bots`	`bots` — боты аккаунта
`GET /api/inbox`	`dialogs`, `unread`, `channels` — диалоги ботов из всех каналов
`GET /api/crm`	`spaces`, `space`, `members`, `summary` — CRM
`GET /api/ev`	`events`, `sub` — мероприятия и билеты
`GET /api/integrations`	`integrations` — интеграции Woove Connect
`GET /api/catalog`	`items`, `plans`, `trial_days` — каталог интеграций и цены
`GET /api/billing/invoices`	`invoices` — счета
`GET /api/team`	`members`, `memberships` — команда
`GET /api/tokens`	`tokens` — ключи API (без самих ключей)

Изменения

POST, PATCH и DELETE — те же адреса, что использует кабинет; тела запросов — JSON. Для сайтов удобнее MCP: там у каждого инструмента описаны параметры (см. «Инструменты MCP»). Для остального ориентируйтесь на вкладку «Сеть» браузера в кабинете — он ходит в те же адреса с теми же телами.

Оформление базы знаний

Поле theme — то же, что «Настройки» → «Оформление» в кабинете: логотип, значок, ссылки в шапке и подвале и свой CSS. Меняется PATCH-запросом на /api/kb/<id>; адреса картинок — с домена базы (/img/…, загрузка через POST /api/kb/<id>/upload с data:image) или абсолютные. Ссылок в шапке до пяти, в подвале до шести, CSS до 12 000 знаков.

json

{ "theme": {
  "logo": "https://example.com/logo.svg",
  "favicon": "https://example.com/favicon.svg",
  "links": [{ "text": "Сайт", "url": "https://example.com" }],
  "footerLinks": [{ "text": "Тарифы", "url": "https://example.com/tarify" }],
  "css": ".hero h1{letter-spacing:0}"
} }

Ограничения

Ключ действует от имени аккаунта: чужие сайты, базы и боты не видны
Не больше двадцати ключей на аккаунт; у ключа видно, когда он использовался в последний раз
Ключ — это полный доступ к аккаунту: храните как пароль, подрядчику выдайте отдельный ключ и отзовите после работ

Для приёма заявок с чужого сайта ключ не нужен — используйте Woove Connect (HTML-форма, скрипт или API).

Читайте дальше

Помогла статья?