AiHummer
Монгол▾
НэвтрэхБүртгэл
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Вебхук, SCIM ба Хослуулах

Вебхук, SCIM ба Хослуулах

v1.1.x · шинэчилсэн 2026-07-05

Энэхүү хуудас нь үлдсэн протоколын талуудыг хамарна: төхөөрөмжийн хослуулалт, аж ахуйн нэгж нийтлэг баталгаажуулалт (SAML / SCIM / OAuth), оролцохыг сонгох MCP сервер болон A2A төгсгөлийн цэгүүд, медиа шилжүүлэх, ба 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 Нөхцөлт хэрэглэгчийн үйлчилгээ (SAML хариу)
GET /saml/login SAML нэвтрэлт эхлүүлэх

SCIM хангах

Салбар хоорондын Танилт Менежментын Систем (SCIM 2.0) нь таны IdP-д хэрэглэгчдийг автоматаар үүсгэж, удирдах боломжийг олгодог.

Арга ба зам Зорилго
.../scim/v2/Users Хэрэглэгчдийг жагсаах / үүсгэх
.../scim/v2/Users/{id} Хэрэглэгчийг унших / шинэчлэх / устгах

SCIM төгсгөлийн цэгүүд нь нэгэнтэй нэвтэрч баталгааждаг оршин суугчаар SCIM дамжуулагч токен, гаргасан (мөн эргүүлэн болгосон/цуцалсан) үед 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)

[!WARNING] Зөвхөн AIHUMMER_MCP_PUBLISH=1 хангалтгүй. Энэ нь хаягийг нээх боловч экспортын жагсаалт хоосон байна: tools/list хоосон массив буцааж, аливаа дуудлагыг татгалзана. Хэрэгтэй хэрэгслүүдээ AIHUMMER_MCP_EXPORT_TOOLS дотор яг нэрээр нь, таслалаар тусгаарлан жагсаана — загвар болон * дэмжигддэггүй. Гадагш зөвхөн унших хэрэгслүүдийг гаргаж болно: http_request, web_fetch, browser, code_exec болон filesystem_read нь бичсэн ч хэзээ ч экспортлогддоггүй.

Хоёр тохиргоог хоёуланг нь Удирдлага → Тохиргоо хэсэгт эсвэл aihummer settings set тушаалаар өгнө, gateway.env дотор биш — эдгээр түлхүүрийн хувьд орчны хувьсагчийг үл тооно. AIHUMMER_MCP_PUBLISH яг 1 утгыг л хүлээн авна: true буюу on бол хаягийг хаалттай орхино. Өөрчлөлт гарцыг дахин эхлүүлсний дараа хүчин төгөлдөр болно.

Клиент Authorization: Bearer … толгойд mcp хамрах хүрээтэй API түлхүүр илгээх ёстой; түүнгүйгээр хариу нь 401.

[!NOTE] Гадагш хэвлэлийн хэрэгслүүдийг ашиглах нь MCP серверийг идэх зүйл болгон ашиглахаас ялгаатай юм кодгүй нэгдэлт. Энэ төгсгөл нь бусад MCP клиентүүдийг дуудах боломж олгоход зориулагдсан АйХаммер.

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-ууд хүчинтэй хэвээр байна дахин эхэлдэг.

RPC үйлчилгээтэй холбох

Төлөвлөсөн, урсгал үйлчлүүлэгчдэд AiHummer мөн ил гаргадаг RPC-тай холбох HTTP дээрх үйлчилгээ (сервер-урсгалыг дэмжинэ):

Үйлчилгээ Талбай
aihummer.health.v1 Эрүүл мэндийн үзлэг
aihummer.event.v1 Өөрчлөлтийн урсгал
aihummer.conversation.v1 Яриа
aihummer.push.v1 Өтгөрүүлэлт хүргэлт
aihummer.media.v1 Мэдээллийн дамжуулалт
aihummer.turn.v1 Эргэлтийн гүйцэтгэл

Дараа хаашаа явах вэ