AiHummer
Հայերեն▾
Մուտք
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Webhooks, SCIM և զուգակցում

Webhooks, SCIM և զուգակցում

v1.0.x · թարմացվել է 2026-06-26

Այս էջը ընդգրկում է մնացած արձանագրությունների մակերեսները՝ սարքի զուգակցում, ձեռնարկության auth federation (SAML / SCIM / OAuth), ընտրովի MCP սերվեր և A2A վերջնակետներ, մեդիա փոխանցում և Connect-RPC ծառայություններ։ Դրանցից մի քանիսը լռելյայն անջատված են և պետք է հստակորեն միացվեն։

Սարքի զուգակցում

Բջջային և աշխատասեղանի client-ները միանում են instance-ին կարճ զուգակցման փոխանակմամբ (iOS/macOS հավելվածն օգտագործում է միայն QR զուգակցում)։

Մեթոդ և path Նպատակ
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" }'

Auth federation

AiHummer-ը ինտեգրվում է ձեռնարկության ինքնության մատակարարների հետ՝ թե՛ մուտքի, թե՛ օգտատերերի մատակարարման համար։

SAML

Մեթոդ և path Նպատակ
GET /saml/metadata Service-provider metadata ձեր IdP-ի համար
POST /saml/acs Assertion Consumer Service (SAML response)
GET /saml/login Սկսել SAML մուտք

SCIM մատակարարում

System for Cross-domain Identity Management (SCIM 2.0)-ը թույլ է տալիս ձեր IdP-ին ավտոմատ կերպով ստեղծել և կառավարել օգտատերերին։

Մեթոդ և path Նպատակ
.../scim/v2/Users Ցուցակել / ստեղծել օգտատերեր
.../scim/v2/Users/{id} Կարդալ / թարմացնել / ջնջել օգտատեր

OAuth token

Մեթոդ և path Նպատակ
POST /v1/oauth/token OAuth token վերջնակետ

MCP սերվեր (հրապարակում դեպի դուրս)

AiHummer-ը կարող է հրապարակել իր սեփական գործիքները MCP client-ներին՝ հանդես գալով որպես MCP սերվեր։ Սա ընտրովի է և անջատված, քանի դեռ չեք սահմանել AIHUMMER_MCP_PUBLISH=1։

Մեթոդ և path Նպատակ
POST /v1/mcp MCP սերվերի վերջնակետ (պահանջում է AIHUMMER_MCP_PUBLISH=1)

[!NOTE] Գործիքների հրապարակումը դեպի դուրս տարբերվում է MCP սերվերի սպառումից որպես զրո-կոդ ինտեգրում։ Այս վերջնակետը նախատեսված է թույլ տալու այլ MCP client-ներին կանչել AiHummer։

A2A (Agent-to-Agent)

AiHummer-ը կարող է բացահայտել A2A մակերես, որպեսզի այլ գործակալներ կարողանան հայտնաբերել և հաղորդագրել իրեն։ Սա նույնպես ընտրովի է AIHUMMER_A2A_PUBLISH=1-ի միջոցով։

Մեթոդ և path Նպատակ
GET /.well-known/agent.json A2A գործակալի քարտ / discovery փաստաթուղթ
POST /a2a/message Ստանալ A2A հաղորդագրություն (պահանջում է AIHUMMER_A2A_PUBLISH=1)

Մեդիա

Մեծ մեդիան (աուդիո, պատկերներ, ֆայլեր) վերբեռնվում և բերվում է հատուկ վերջնակետների միջոցով, այլ ոչ թե ներդրվում JSON մարմիններում։

Մեթոդ և path Նպատակ
PUT /v1/media/{id}/content Վերբեռնել մեդիա օբյեկտի բայթերը
GET /v1/files/{id} Ներբեռնել պահված ֆայլը

[!TIP] Սահմանեք AIHUMMER_BLOB_DIR՝ media/file ծառայությունը միացնելու համար, և AIHUMMER_MEDIA_TOKEN_SECRET՝ որպեսզի ստորագրված ներբեռնման URL-ները մնան վավեր վերագործարկումների ընթացքում։

Connect-RPC ծառայություններ

Տիպավորված, հոսքային client-ների համար AiHummer-ը նաև բացահայտում է Connect-RPC ծառայություններ HTTP-ով (server-streaming-ն աջակցվում է)՝

Ծառայություն Ոլորտ
aihummer.health.v1 Health checks
aihummer.event.v1 Իրադարձությունների հոսք
aihummer.conversation.v1 Զրույցներ
aihummer.push.v1 Push առաքում
aihummer.media.v1 Մեդիա փոխանցում
aihummer.turn.v1 Կանչի կատարում

Ուր գնալ հաջորդիվ