Webhooks, SCIM და დაწყვილება

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

ეს გვერდი მოიცავს დარჩენილ პროტოკოლის ზედაპირებს: **მოწყობილობის დაწყვილებას**, საწარმოო **ავთენტიკაციის ფედერაციას** (SAML / SCIM / OAuth), არჩევით **MCP სერვერსა** და **A2A** endpoint-ებს, **მედიის** გადაცემას, და **Connect-RPC** სერვისებს. რამდენიმე მათგანი ნაგულისხმევად გამორთულია და უნდა ჩაირთოს აშკარად. ## მოწყობილობის დაწყვილება მობილური და დესკტოპის კლიენტები უერთდებიან ინსტანციას მოკლე დაწყვილების გაცვლის გზით (iOS/macOS აპი იყენებს QR-მხოლოდ დაწყვილებას). | მეთოდი და path | დანიშნულება | |---|---| | `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 | მეთოდი და path | დანიშნულება | |---|---| | `GET /saml/metadata` | სერვის-პროვაიდერის metadata თქვენი IdP-სთვის | | `POST /saml/acs` | Assertion Consumer Service (SAML პასუხი) | | `GET /saml/login` | SAML შესვლის ინიცირება | ### SCIM პროვიზიონირება System for Cross-domain Identity Management (SCIM 2.0) საშუალებას აძლევს თქვენს IdP-ს ავტომატურად შექმნას და მართოს მომხმარებლები. | მეთოდი და path | დანიშნულება | |---|---| | `.../scim/v2/Users` | მომხმარებლების ჩამონათვალი / შექმნა | | `.../scim/v2/Users/{id}` | მომხმარებლის წაკითხვა / განახლება / წაშლა | ### OAuth ტოკენი | მეთოდი და path | დანიშნულება | |---|---| | `POST /v1/oauth/token` | OAuth ტოკენის endpoint | ## MCP სერვერი (გარეთ გამოქვეყნება) AiHummer-ს შეუძლია გამოაქვეყნოს საკუთარი ხელსაწყოები MCP კლიენტებზე **MCP სერვერად** მოქმედებით. ეს არის **არჩევითი** და გამორთულია, თუ არ დააყენებთ `AIHUMMER_MCP_PUBLISH=1`. | მეთოდი და path | დანიშნულება | |---|---| | `POST /v1/mcp` | MCP სერვერის endpoint (საჭიროებს `AIHUMMER_MCP_PUBLISH=1`) | > [!NOTE] > ხელსაწყოების გარეთ გამოქვეყნება განსხვავდება MCP სერვერის *მოხმარებისგან* როგორც > კოდის-გარეშე ინტეგრაცია. ეს endpoint არის სხვა MCP კლიენტებისთვის, რათა მათ AiHummer-ში > გამოიძახონ. ## A2A (Agent-to-Agent) AiHummer-ს შეუძლია გამოაქვეყნოს A2A ზედაპირი ისე, რომ სხვა აგენტებმა შეძლონ მისი აღმოჩენა და შეტყობინების გაგზავნა. ეს ასევე **არჩევითია** `AIHUMMER_A2A_PUBLISH=1`-ის გავლით. | მეთოდი და path | დანიშნულება | |---|---| | `GET /.well-known/agent.json` | A2A აგენტის ბარათი / აღმოჩენის დოკუმენტი | | `POST /a2a/message` | A2A შეტყობინების მიღება (საჭიროებს `AIHUMMER_A2A_PUBLISH=1`) | ## მედია დიდი მედია (აუდიო, სურათები, ფაილები) იტვირთება და მოიპოვება გამოყოფილი endpoint-ების გავლით, ვიდრე JSON სხეულებში ჩაშენდება. | მეთოდი და path | დანიშნულება | |---|---| | `PUT /v1/media/{id}/content` | მედია ობიექტისთვის ბაიტების ატვირთვა | | `GET /v1/files/{id}` | შენახული ფაილის ჩამოტვირთვა | > [!TIP] > დააყენეთ `AIHUMMER_BLOB_DIR` რათა ჩართოთ მედია/ფაილის სერვისი, და > `AIHUMMER_MEDIA_TOKEN_SECRET` რათა ხელმოწერილი ჩამოტვირთვის URL-ები ვალიდური დარჩეს > გადატვირთვებს შორის. ## Connect-RPC სერვისები ტიპიზებული, სტრიმინგ კლიენტებისთვის AiHummer ასევე აქვეყნებს **Connect-RPC** სერვისებს HTTP-ზე (სერვერ-სტრიმინგი მხარდაჭერილია): | სერვისი | სფერო | |---|---| | `aihummer.health.v1` | ჯანმრთელობის შემოწმებები | | `aihummer.event.v1` | მოვლენების სტრიმი | | `aihummer.conversation.v1` | საუბრები | | `aihummer.push.v1` | Push მიწოდება | | `aihummer.media.v1` | მედიის გადაცემა | | `aihummer.turn.v1` | ბრუნვის შესრულება | ## სად შემდეგ - შეიტანეთ შეტყობინებები AiHummer-ში: [შემომავალი და ინტეგრაციის ტრიგერები](/ka/v1.0/api/inbound-triggers). - ჩართეთ ეს ზედაპირები და მეტი: [გარემოს ცვლადები](/ka/v1.0/reference/env-vars). - ინსტანციის ოპერირება: [CLI მითითება](/ka/v1.0/reference/cli).