AiHummer
Русский▾
Войти
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Вебхуки, SCIM и pairing

Вебхуки, SCIM и pairing

v1.0.x · обновлено 2026-07-05

Эта страница покрывает оставшиеся протокольные поверхности: 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} Чтение / обновление / удаление пользователя

SCIM-эндпоинты аутентифицируются SCIM bearer-токеном арендатора, который выпускается (и ротируется/отзывается) через POST /v1/admin/scim/token; IdP передаёт его в заголовке Authorization: Bearer. Токен показывается один раз при выпуске.

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)

Куда дальше