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 Амаҵзура-провайдер аметадан шәара 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 (Агент-Агент)

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 ала (сервер-стриминг иадгылоуп):

Амаҵзура Аобласт
aihummer.health.v1 Агәабзиара агәаҭарақәа
aihummer.event.v1 Аивент-астрим
aihummer.conversation.v1 Аиҿцәажәарақәа
aihummer.push.v1 Push-аиагара
aihummer.media.v1 Амедиа аиагара
aihummer.turn.v1 Абжьабыргра анагӡара

Уаха ахь