[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-management-keys":3,"docs-tabs-management-keys":6},{"content":4,"lastmod":5},"# Менеджмент-ключи\n\nМенеджмент-ключи (`vibe_live_`) не привязаны к одному порталу и предназначены для автоматизации администрирования: управления API-ключами, просмотра порталов и работы с обратной связью.\n\n## Отличие от ключей портала\n\n| Возможность | API-ключ (`vibe_api_`) | Ключ авторизации (`vibe_app_`) | Менеджмент-ключ (`vibe_live_`) |\n|-------------|------------------------|--------------------------------|--------------------------------|\n| Привязка к порталу | Да (один портал) | Да (один портал) | Нет (все порталы пользователя) |\n| Доступ к сущностям Битрикс24 (deals, tasks и др.) | Да | Да | Нет |\n| Управление API-ключами | Нет | Нет | Да |\n| Просмотр списка порталов | Нет | Нет | Да |\n| Работа с обратной связью | Только свои тикеты | Только свои тикеты | Все тикеты платформы |\n| Справочник API (`\u002Fv1\u002Fguide`) | Отфильтрован по скоупам | Отфильтрован по скоупам | Полный (все сущности) |\n\n## Скоупы менеджмент-ключа\n\nКаждый менеджмент-ключ создаётся с одним или несколькими скоупами. Без нужного скоупа конкретный эндпоинт возвращает `403 MANAGEMENT_SCOPE_REQUIRED` — даже если эндпоинт в принципе доступен менеджмент-ключам.\n\n| Скоуп | Открывает |\n|-------|-----------|\n| `vibe:mgmt:keys` | `\u002Fv1\u002Fkeys` (список, создание, изменение, удаление, перевыпуск) |\n| `vibe:mgmt:portals` | `\u002Fv1\u002Fportals` |\n| `vibe:mgmt:feedback` | `\u002Fv1\u002Ffeedback` (список тикетов, чтение, обновление, комментарии) |\n\nЭндпоинты `\u002Fv1\u002Fme`, `\u002Fv1\u002Fguide` и `\u002Fv1\u002Fopenapi.json` доступны любому менеджмент-ключу без отдельного скоупа.\n\nПри создании ключа выбирайте только нужные скоупы — если ключ предназначен только для управления API-ключами, скоуп `vibe:mgmt:feedback` ему не нужен.\n\n## Доступные эндпоинты\n\nПри обращении к эндпоинтам сущностей Битрикс24 возвращается `403 MANAGEMENT_KEY_NO_ENTITY_ACCESS`.\n\n### `GET \u002Fv1\u002Fme` — самоописание ключа\n\nВозвращает тип ключа, список порталов с ролями и количеством ключей, перечень доступных эндпоинтов и быстрый старт.\n\n```bash\ncurl -H \"X-Api-Key: vibe_live_abc123...\" \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fme\n```\n\nОтвет:\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"type\": \"management\",\n    \"keyPrefix\": \"vibe_live_abc123\",\n    \"keySuffix\": \"f9d2\",\n    \"expiresAt\": null,\n    \"scopes\": [],\n    \"capabilities\": [\n      \"GET https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fme — this endpoint (management key self-description)\",\n      \"GET https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fguide — full API reference (portal-agnostic)\",\n      \"GET https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fkeys — list APP keys for a portal (requires portalId query param)\",\n      \"POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fkeys — create APP key (requires portalId in body)\",\n      \"GET https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fportals — list your portals\",\n      \"GET https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffeedback — list ALL platform feedback (management key sees everything)\",\n      \"GET https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffeedback\u002F:id — feedback details including comment thread\",\n      \"PATCH https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffeedback\u002F:id — update status\u002Fresolution (legacy, prefer \u002Fcomments)\",\n      \"POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffeedback\u002F:id\u002Fcomments — post a team comment, changes status\"\n    ],\n    \"portals\": [\n      {\n        \"id\": \"portal-uuid\",\n        \"domain\": \"mycompany.bitrix24.ru\",\n        \"status\": \"ACTIVE\",\n        \"role\": \"ADMIN\",\n        \"appKeyCount\": 3\n      }\n    ],\n    \"totalAppKeys\": 3,\n    \"quickstart\": {\n      \"step1\": \"GET https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fportals — list available portals\",\n      \"step2\": \"GET https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fkeys?portalId=\u003Cid> — list APP keys for a portal\",\n      \"step3\": \"POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fkeys { portalId, name, scopes } — create an APP key\",\n      \"step4\": \"Use the APP key for entity API calls (deals, tasks, etc.)\"\n    },\n    \"docs\": \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fdocs\u002Fmanagement-keys\"\n  }\n}\n```\n\nВ ответе также присутствует объект `feedback` со справочником эндпоинтов, статусов и фильтров для работы с тикетами обратной связи — он используется AI-моделями для автоматической обработки тикетов.\n\n### `GET \u002Fv1\u002Fguide` — справочник API\n\nВозвращает полный справочник API со всеми сущностями (без фильтрации по скоупам). Используется для подбора нужных эндпоинтов перед созданием API-ключей.\n\n```bash\ncurl -H \"X-Api-Key: vibe_live_abc123...\" \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fguide\n```\n\n### `GET \u002Fv1\u002Fopenapi.json` — OpenAPI-спецификация\n\nВозвращает машинно-читаемую OpenAPI 3.1 спецификацию платформы Вайбкод.\n\n```bash\ncurl -H \"X-Api-Key: vibe_live_abc123...\" \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fopenapi.json\n```\n\n### `GET \u002Fv1\u002Fportals` — список порталов\n\nВозвращает порталы, к которым пользователь имеет доступ, с ролью на каждом портале.\n\n```bash\ncurl -H \"X-Api-Key: vibe_live_abc123...\" \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fportals\n```\n\n### `GET \u002Fv1\u002Fkeys` — список API-ключей портала\n\nПараметр `portalId` обязателен.\n\n```bash\ncurl -H \"X-Api-Key: vibe_live_abc123...\" \\\n  \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fkeys?portalId=portal-uuid\"\n```\n\n### `POST \u002Fv1\u002Fkeys` — создание API-ключа\n\nСоздаёт новый API-ключ (`vibe_api_`) для указанного портала. В теле передаётся `portalId`, имя и список скоупов. Полный ключ возвращается в поле `rawKey` один раз — сохраните его сразу.\n\n```bash\ncurl -X POST \\\n  -H \"X-Api-Key: vibe_live_abc123...\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"portalId\": \"portal-uuid\", \"name\": \"My Key\", \"scopes\": [\"crm\", \"task\"]}' \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fkeys\n```\n\nДополнительные коды ошибок:\n\n| Код | HTTP | Когда возвращается |\n|-----|------|---------------------|\n| `MISSING_PORTAL_ID` | 400 | В теле запроса не указан `portalId` |\n| `NOT_PORTAL_MEMBER` | 403 | Владелец ключа не состоит в указанном портале |\n| `PORTAL_NOT_LINKED` | 400 | Портал не подключён к Битрикс24 Network — создать ключ невозможно |\n| `BITRIX_UNAVAILABLE` | 502 | Битрикс24 не ответил на регистрацию входящего вебхука |\n\n### `GET \u002Fv1\u002Fkeys\u002F:id` — данные одного ключа\n\nВозвращает данные ключа без секрета (только префикс, имя, скоупы, статус).\n\n```bash\ncurl -H \"X-Api-Key: vibe_live_abc123...\" \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fkeys\u002Fkey-uuid\n```\n\n### `PATCH \u002Fv1\u002Fkeys\u002F:id` — обновление ключа\n\nМожно изменить любое из полей ниже (все необязательны, передавайте только то, что меняете):\n\n| Поле | Тип | Описание |\n|------|-----|----------|\n| `name` | string | Имя ключа в личном кабинете |\n| `scopes` | string[] | Список скоупов — см. [Скоупы](.\u002Fscopes.md) |\n| `status` | `\"ACTIVE\"` \\| `\"REVOKED\"` | Активация или отзыв ключа |\n| `ipWhitelist` | string[] | Список разрешённых IP-адресов |\n| `rateLimit` | number \\| null | Индивидуальный лимит запросов в секунду |\n| `expiresAt` | ISO-8601 \\| null | Срок действия ключа (`null` — бессрочный) |\n\n```bash\ncurl -X PATCH \\\n  -H \"X-Api-Key: vibe_live_abc123...\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"status\": \"REVOKED\"}' \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fkeys\u002Fkey-uuid\n```\n\n### `DELETE \u002Fv1\u002Fkeys\u002F:id` — удаление ключа\n\nУдаляет ключ. Если на ключе есть активные серверы, возвращается `409 KEY_HAS_ACTIVE_SERVERS` — серверы нужно удалить первыми.\n\n```bash\ncurl -X DELETE \\\n  -H \"X-Api-Key: vibe_live_abc123...\" \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fkeys\u002Fkey-uuid\n```\n\n### `POST \u002Fv1\u002Fkeys\u002F:id\u002Frotate` — перевыпуск ключа\n\nСоздаёт новый ключ с теми же настройками и оставляет старому переходный период 24 часа. После перевыпуска старый ключ автоматически становится недействительным.\n\n```bash\ncurl -X POST \\\n  -H \"X-Api-Key: vibe_live_abc123...\" \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fkeys\u002Fkey-uuid\u002Frotate\n```\n\n### `GET \u002Fv1\u002Ffeedback` — список тикетов обратной связи\n\nВозвращает все тикеты обратной связи на платформе. Поддерживает фильтры по статусу, категории, порталу и постраничную выборку.\n\n```bash\ncurl -H \"X-Api-Key: vibe_live_abc123...\" \\\n  \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffeedback?status=NEW&page=1&limit=50\"\n```\n\n### `GET \u002Fv1\u002Ffeedback\u002F:id` — карточка тикета\n\nВозвращает тикет со всем тредом комментариев.\n\n### `PATCH \u002Fv1\u002Ffeedback\u002F:id` — обновление тикета\n\nМеняет статус и резолюцию тикета.\n\n### `POST \u002Fv1\u002Ffeedback\u002F:id\u002Fcomments` — комментарий к тикету\n\nДобавляет команду в тред и одновременно меняет статус. Используется AI-моделями для ответа пользователю.\n\n#### Статусы тикетов\n\n| Статус | Когда применяется |\n|--------|-------------------|\n| `NEW` | Пользователь только что отправил тикет, никто его ещё не смотрел |\n| `REVIEWING` | Команда взяла тикет в работу, пользователь пока не получает обновлений |\n| `AWAITING_USER` | Команда задала пользователю уточняющий вопрос — ждём ответа (пользователь получает письмо) |\n| `NEEDS_REVIEW` | Пользователь ответил на уточнение — команда читает новый комментарий и решает следующий шаг |\n| `RESOLVED` | Исправление опубликовано в продуктовой среде, пользователь получил уведомление |\n| `ARCHIVED` | Закрыт без правки кода (дубликат, вне темы, не воспроизводится) |\n\n#### Категории тикетов\n\n`BUG`, `SUGGESTION`, `DOCS`, `CHAT`, `BOTS`, `OTHER`.\n\n#### Фильтры списка\n\n`?status=NEW&category=BUG&portalId=\u003Cuuid>&page=1&limit=50`. Параметр `limit` ограничен значением 100.\n\n## Быстрый старт\n\n1. Создайте менеджмент-ключ в личном кабинете (раздел «Менеджмент-ключи»)\n2. Получите список порталов: `GET \u002Fv1\u002Fportals`\n3. Посмотрите существующие ключи на нужном портале: `GET \u002Fv1\u002Fkeys?portalId=\u003Cid>`\n4. Создайте API-ключ с нужными скоупами: `POST \u002Fv1\u002Fkeys { portalId, name, scopes }`\n5. Используйте полученный API-ключ (`vibe_api_…`) для работы с данными Битрикс24\n\n## Ограничения\n\n- Менеджмент-ключи не могут обращаться к эндпоинтам сущностей Битрикс24 (`\u002Fv1\u002Fdeals`, `\u002Fv1\u002Ftasks` и другим)\n- Для работы с данными используйте API-ключ (`vibe_api_`) или ключ авторизации (`vibe_app_`)\n- При попытке обратиться к неподдерживаемому эндпоинту возвращается `403 MANAGEMENT_KEY_NO_ENTITY_ACCESS`\n\n## Смотрите также\n\n- [Ключи и авторизация](.\u002Fkeys-auth.md) — создание ключа, типы, передача, лимиты, IP, жизненный цикл, безопасность\n- [Скоупы](.\u002Fscopes.md) — справочник скоупов и как их выбрать\n- [Быстрый старт](.\u002Fquickstart.md) — первый запрос за 2 минуты\n- [Оптимизация и batch](.\u002Foptimization.md) — ускорение в 50 раз через `POST \u002Fv1\u002Fbatch`\n- [Коды ошибок](.\u002Ferrors.md) — справочник ошибок API\n","2026-07-07",{}]