Вебхуки, SCIM и pairing — AiHummer Документация

Эта страница покрывает оставшиеся протокольные поверхности: pairing устройств, корпоративную федерацию аутентификации (SAML / SCIM / OAuth), опциональные MCP-сервер и A2A-эндпоинты, передачу медиа и сервисы Connect-RPC. Некоторые из них по умолчанию выключены и включаются явно.

Pairing устройств

Мобильные и десктоп-клиенты подключаются к инстансу через короткий обмен pairing (приложение iOS/macOS использует pairing только по QR).

Метод и путь	Назначение
`POST /v1/pairing/redeem`	Погасить код pairing и подготовить устройство
`POST /v1/pairing/device/validate`	Проверить уже сопряжённое устройство

curl https://your-aihummer.example/v1/pairing/redeem \
  -H "Content-Type: application/json" \
  -d '{ "code": "ABCD-EFGH" }'

Федерация аутентификации

AiHummer интегрируется с корпоративными провайдерами идентичности как для входа, так и для провижининга пользователей.

SAML

Метод и путь	Назначение
`GET /saml/metadata`	Метаданные service-provider для вашего IdP
`POST /saml/acs`	Assertion Consumer Service (ответ SAML)
`GET /saml/login`	Инициировать вход через SAML

Провижининг SCIM

SCIM 2.0 (System for Cross-domain Identity Management) позволяет вашему IdP автоматически создавать пользователей и управлять ими.

Метод и путь	Назначение
`.../scim/v2/Users`	Список / создание пользователей
`.../scim/v2/Users/{id}`	Чтение / обновление / удаление пользователя

OAuth-токен

Метод и путь	Назначение
`POST /v1/oauth/token`	Эндпоинт выдачи OAuth-токена

MCP-сервер (публикация наружу)

AiHummer может публиковать собственные инструменты для MCP-клиентов, выступая как MCP-сервер. Это опционально и выключено, пока вы не установите AIHUMMER_MCP_PUBLISH=1.

Метод и путь	Назначение
`POST /v1/mcp`	Эндпоинт MCP-сервера (требует `AIHUMMER_MCP_PUBLISH=1`)

[!NOTE] Публикация инструментов наружу отличается от потребления MCP-сервера как zero-code интеграции. Этот эндпоинт нужен, чтобы другие MCP-клиенты могли обращаться к AiHummer.

A2A (Agent-to-Agent)

AiHummer может предоставлять A2A-поверхность, чтобы другие агенты могли его обнаруживать и писать ему. Это тоже опционально через AIHUMMER_A2A_PUBLISH=1.

Метод и путь	Назначение
`GET /.well-known/agent.json`	Карточка агента A2A / документ discovery
`POST /a2a/message`	Приём A2A-сообщения (требует `AIHUMMER_A2A_PUBLISH=1`)

Медиа

Крупные медиа (аудио, изображения, файлы) загружаются и скачиваются через выделенные эндпоинты, а не встраиваются в JSON-тела.

Метод и путь	Назначение
`PUT /v1/media/{id}/content`	Загрузить байты медиа-объекта
`GET /v1/files/{id}`	Скачать сохранённый файл

[!TIP] Установите AIHUMMER_BLOB_DIR, чтобы включить сервис медиа/файлов, и AIHUMMER_MEDIA_TOKEN_SECRET, чтобы подписанные URL для скачивания оставались валидными после перезапусков.

Сервисы Connect-RPC

Для типизированных стриминговых клиентов AiHummer также предоставляет сервисы Connect-RPC поверх HTTP (поддерживается server-streaming):

Сервис	Область
`aihummer.health.v1`	Проверки здоровья
`aihummer.event.v1`	Поток событий
`aihummer.conversation.v1`	Беседы
`aihummer.push.v1`	Доставка push
`aihummer.media.v1`	Передача медиа
`aihummer.turn.v1`	Выполнение хода (turn)

Куда дальше

Доставка сообщений в AiHummer: Входящие и интеграционные триггеры.
Переключение этих и других поверхностей: Переменные окружения.
Управление инстансом: Справочник CLI.