AiHummer
Тоҷикӣ▾
Даромадан
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Webhook-ҳо, SCIM ва ҷуфтсозӣ

Webhook-ҳо, 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 Иҷрои навбат

Минбаъд ба куҷо