Webhook-lar, SCIM və cütləşmə

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

Bu səhifə qalan protokol səthlərini əhatə edir: **cihaz cütləşməsi**, korporativ **auth federasiyası** (SAML / SCIM / OAuth), könüllü **MCP serveri** və **A2A** endpoint-ləri, **media** transferi, və **Connect-RPC** xidmətləri. Bunların bir neçəsi defolt olaraq söndürülmüşdür və açıq şəkildə aktivləşdirilməlidir. ## Cihaz cütləşməsi Mobil və masaüstü müştərilər instansiyaya qısa cütləşmə mübadiləsi vasitəsilə qoşulur (iOS/macOS tətbiqi yalnız-QR cütləşmə istifadə edir). | Metod və yol | Məqsəd | |---|---| | `POST /v1/pairing/redeem` | Cütləşmə kodunu istifadə et və cihazı provizionlaşdır | | `POST /v1/pairing/device/validate` | Artıq cütləşdirilmiş cihazı doğrula | ```bash curl https://your-aihummer.example/v1/pairing/redeem \ -H "Content-Type: application/json" \ -d '{ "code": "ABCD-EFGH" }' ``` ## Auth federasiyası AiHummer həm giriş, həm də istifadəçi provizionlaşdırması üçün korporativ kimlik provayderləri ilə inteqrasiya olunur. ### SAML | Metod və yol | Məqsəd | |---|---| | `GET /saml/metadata` | IdP-niz üçün xidmət-provayder metadata-sı | | `POST /saml/acs` | Assertion Consumer Service (SAML cavabı) | | `GET /saml/login` | SAML girişini başlat | ### SCIM provizionlaşdırma System for Cross-domain Identity Management (SCIM 2.0) IdP-nizə istifadəçiləri avtomatik yaratmağa və idarə etməyə imkan verir. | Metod və yol | Məqsəd | |---|---| | `.../scim/v2/Users` | İstifadəçiləri siyahıla / yarat | | `.../scim/v2/Users/{id}` | İstifadəçini oxu / yenilə / sil | ### OAuth token | Metod və yol | Məqsəd | |---|---| | `POST /v1/oauth/token` | OAuth token endpoint-i | ## MCP serveri (kənara yayımla) AiHummer **MCP serveri** kimi fəaliyyət göstərərək öz alətlərini MCP müştərilərinə yayımlaya bilər. Bu **könüllüdür** və siz `AIHUMMER_MCP_PUBLISH=1` təyin etmədikcə söndürülmüşdür. | Metod və yol | Məqsəd | |---|---| | `POST /v1/mcp` | MCP server endpoint-i (`AIHUMMER_MCP_PUBLISH=1` tələb edir) | > [!NOTE] > Alətləri kənara yayımlamaq bir MCP serverini sıfır-kodlu inteqrasiya kimi > *istehlak etməkdən* fərqlidir. Bu endpoint digər MCP müştərilərinin AiHummer-ə zəng > etməsinə imkan vermək üçündür. ## A2A (Agent-to-Agent) AiHummer digər agentlərin onu kəşf edib mesaj göndərə bilməsi üçün bir A2A səthi təqdim edə bilər. Bu da `AIHUMMER_A2A_PUBLISH=1` vasitəsilə **könüllüdür**. | Metod və yol | Məqsəd | |---|---| | `GET /.well-known/agent.json` | A2A agent kartı / kəşf sənədi | | `POST /a2a/message` | A2A mesajı qəbul et (`AIHUMMER_A2A_PUBLISH=1` tələb edir) | ## Media Böyük media (audio, şəkillər, fayllar) JSON gövdələrə yerləşdirilmək əvəzinə xüsusi endpoint-lər vasitəsilə yüklənir və əldə edilir. | Metod və yol | Məqsəd | |---|---| | `PUT /v1/media/{id}/content` | Media obyekti üçün baytları yüklə | | `GET /v1/files/{id}` | Saxlanılan faylı endir | > [!TIP] > Media/fayl xidmətini aktivləşdirmək üçün `AIHUMMER_BLOB_DIR`, və imzalanmış endirmə > URL-lərinin yenidən başlatmalar arasında etibarlı qalması üçün > `AIHUMMER_MEDIA_TOKEN_SECRET` təyin edin. ## Connect-RPC xidmətləri Tipli, axın müştəriləri üçün AiHummer həmçinin HTTP üzərində **Connect-RPC** xidmətlərini təqdim edir (server-axını dəstəklənir): | Xidmət | Sahə | |---|---| | `aihummer.health.v1` | Sağlamlıq yoxlamaları | | `aihummer.event.v1` | Hadisə axını | | `aihummer.conversation.v1` | Söhbətlər | | `aihummer.push.v1` | Push çatdırılması | | `aihummer.media.v1` | Media transferi | | `aihummer.turn.v1` | Növbə icrası | ## Sonra haraya - AiHummer-ə mesajları itələyin: [Daxil olan və inteqrasiya tetikləyiciləri](/en/v1.0/api/inbound-triggers). - Bu səthləri və daha çoxunu açıb-bağlayın: [Mühit dəyişənləri](/en/v1.0/reference/env-vars). - İnstansiyanı idarə edin: [CLI istinadı](/en/v1.0/reference/cli).