AiHummer
Кыргызча▾
КирүүЖеке кабинет
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Вебхуктар, SCIM жана Жупташтыруу

Вебхуктар, SCIM жана Жупташтыруу

v1.2.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 Айландырууну аткаруу

Келерки кайда