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" }'

Федератсияи Auth

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 … калиди API-ро бо доираи mcp фиристад; бидуни он ҷавоб 401 аст.

[!NOTE] Интишори асбобҳо ба берун аз истифода кардани сервери MCP ҳамчун интегратсияи бе код. Ин нуқтаи охир барои иҷозат додан ба муштариёни дигар MCP барои тамос гирифтан ба АйҲаммер.

AGENT-ТО-AGENT (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 низ пешниҳод мекунад Пайвастшавӣ-RPC хизматрасониҳо тавассути HTTP (пешвози ҷараёндиҳӣ аз сервер дастгирӣ мешавад):

Хизмат Минтақа
aihummer.health.v1 Тафтишоти тиббӣ
aihummer.event.v1 Ҷараёни рӯйдодҳо
aihummer.conversation.v1 Сӯҳбатҳо
aihummer.push.v1 Расонидани пуш
aihummer.media.v1 Интиқоли Воситаҳо
aihummer.turn.v1 Иҷрои гардиш

Баъд ба куҷо