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

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

Бул бет калган протокол беттерин камтыйт: **түзмөктү жупташтыруу**, ишкана **аутентификация федерациясы** (SAML / SCIM / OAuth), опт-ин **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 клиенттерине жарыялай алат. Бул **опт-ин** жана `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` коюңуз, жана кол коюлган жүктөп алуу > URLдери кайра иштетүүлөр аркылуу жарактуу бойдон калышы үчүн `AIHUMMER_MEDIA_TOKEN_SECRET` > коюңуз. ## Connect-RPC кызматтары Типтештирилген, стриминг клиенттер үчүн AiHummer **Connect-RPC** кызматтарын дагы HTTP аркылуу чыгарат (сервер-стриминг колдоого алынат): | Кызмат | Аймак | |---|---| | `aihummer.health.v1` | Ден соолукту текшерүүлөр | | `aihummer.event.v1` | Окуя агымы | | `aihummer.conversation.v1` | Маектешүүлөр | | `aihummer.push.v1` | Пуш жеткирүү | | `aihummer.media.v1` | Медиа өткөрүү | | `aihummer.turn.v1` | Кезекти аткаруу | ## Андан ары кайда - AiHummerге билдирүүлөрдү түртүңүз: [Кириш жана интеграция триггерлери](/ky/v1.0/api/inbound-triggers). - Бул беттерди жана башкаларды которуңуз: [Айлана-чөйрө өзгөрмөлөрү](/ky/v1.0/reference/env-vars). - Инстансты иштетиңиз: [CLI шилтемеси](/ky/v1.0/reference/cli).