Webhook-тар, SCIM және жұптау

curl https://your-aihummer.example/v1/pairing/redeem \
  -H "Content-Type: application/json" \
  -d '{ "code": "ABCD-EFGH" }'

Бұл бет қалған хаттама беттерін қамтиды: **құрылғыны жұптау**, кәсіпорын **аутен федерациясы** (SAML / SCIM / OAuth), opt-in **MCP сервері** мен **A2A** эндпоинттері, **медиа** тасымалы және **Connect-RPC** қызметтері. Олардың бірнешеуі әдепкі бойынша өшірулі және анық қосылуы тиіс. ## Құрылғыны жұптау Мобильді және үстелдік клиенттер данаға қысқа жұптау алмасуы арқылы қосылады (iOS/macOS қосымшасы тек QR арқылы жұптауды пайдаланады). | Әдіс және жол | Мақсаты | |---|---| | `POST /v1/pairing/redeem` | Жұптау кодын өтеу және құрылғыны провизиялау | | `POST /v1/pairing/device/validate` | Бұрыннан жұпталған құрылғыны тексеру | ```bash 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 клиенттеріне жариялай алады. Бұл **opt-in** және `AIHUMMER_MCP_PUBLISH=1` орнатпасаңыз өшірулі. | Әдіс және жол | Мақсаты | |---|---| | `POST /v1/mcp` | MCP сервер эндпоинті (`AIHUMMER_MCP_PUBLISH=1` қажет) | > [!NOTE] > Құралдарды сыртқа жариялау MCP серверін код жазбай интеграция ретінде > *тұтынудан* ерекшеленеді. Бұл эндпоинт басқа MCP клиенттеріне AiHummer-ге > қоңырау шалуға мүмкіндік беруге арналған. ## A2A (Agent-to-Agent) AiHummer басқа агенттер оны таба алатын және оған хабарлама жібере алатындай A2A бетін ұсына алады. Бұл да `AIHUMMER_A2A_PUBLISH=1` арқылы **opt-in**. | Әдіс және жол | Мақсаты | |---|---| | `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` орнатыңыз, ал қол қойылған > жүктеу URL-дары қайта іске қосулар бойы жарамды болып қалатындай > `AIHUMMER_MEDIA_TOKEN_SECRET` орнатыңыз. ## Connect-RPC қызметтері Типтелген, стримдік клиенттер үшін AiHummer сонымен қатар HTTP арқылы **Connect-RPC** қызметтерін ұсынады (сервер-стриминг қолдау көрсетіледі): | Қызмет | Сала | |---|---| | `aihummer.health.v1` | Денсаулық тексерулері | | `aihummer.event.v1` | Оқиға стримі | | `aihummer.conversation.v1` | Әңгімелер | | `aihummer.push.v1` | Push жеткізу | | `aihummer.media.v1` | Медиа тасымалы | | `aihummer.turn.v1` | Қадам орындау | ## Келесі қайда - AiHummer-ге хабарламаларды итеру: [Кіріс және интеграция триггерлері](/kk/v1.0/api/inbound-triggers). - Осы беттер мен басқаларын ауыстырып қосу: [Орта айнымалылары](/kk/v1.0/reference/env-vars). - Дананы басқару: [CLI анықтамасы](/kk/v1.0/reference/cli).