AiHummer
Беларуская▾
Увайсці
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Вебхукі, SCIM і спарванне

Вебхукі, SCIM і спарванне

v1.0.x · абноўлена 2026-06-26

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

Спарванне прылад

Мабільныя і настольныя кліенты далучаюцца да экзэмпляра праз кароткі абмен спарвання (дадатак iOS/macOS выкарыстоўвае спарванне толькі праз QR).

Метад і шлях Прызначэнне
POST /v1/pairing/redeem Пагасіць код спарвання і забяспечыць прыладу
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

System for Cross-domain Identity Management (SCIM 2.0) дазваляе вашаму 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-сервера як інтэграцыі без кода. Гэта канчатковая кропка прызначана для таго, каб дазволіць іншым MCP-кліентам зварачацца ў AiHummer.

A2A (Agent-to-Agent)

AiHummer можа прадаставіць паверхню A2A, каб іншыя агенты маглі яго выяўляць і адпраўляць яму паведамленні. Гэта таксама апцыянальна праз AIHUMMER_A2A_PUBLISH=1.

Метад і шлях Прызначэнне
GET /.well-known/agent.json Картка агента A2A / дакумент выяўлення
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 Выкананне ходу

Куды далей