AiHummer
हिन्दी▾
साइन इन करेंखाता
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
एपीआई/वेबहुक्स, SCIM और पेयरिंग

वेबहुक्स, SCIM और पेयरिंग

v1.0.x · अपडेट किया गया 2026-07-05

यह पृष्ठ शेष प्रोटोकॉल सतहों को कवर करता है: डिवाइस पेयरिंग, उद्यम प्रमाणीकरण संघ (SAML / SCIM / OAuth), ऑप्ट-इन एमसीपी सर्वर और A2A एंडपॉइंट्स, मीडिया स्थानांतरण, और कनेक्ट-आरपीसी सेवाएँ। इनमें से कई डिफ़ॉल्ट रूप से अक्षम हैं और इन्हें स्पष्ट रूप से सक्षम करना पड़ता है।

डिवाइस पेयरिंग

मोबाइल और डेस्कटॉप क्लाइंट एक शॉर्ट पेयरिंग एक्सचेंज के माध्यम से किसी इंस्टेंस से जुड़ते हैं (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 लॉगिन और उपयोगकर्ता प्रोविजनिंग दोनों के लिए एंटरप्राइज आइडेंटिटी प्रदाताओं के साथ एकीकृत होता है।

सैमल

विधि और पथ उद्देश्य
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 टोकन एंडपॉइंट

एमसीपी सर्वर (बाहर प्रकाशित करें)

AiHummer अपने उपकरणों को 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 पूरे समय मान्य रहते हैं पुनःप्रारंभ करता है।

कनेक्ट-आरपीसी सेवाएँ

टाइप किए गए, स्ट्रीमिंग क्लाइंट्स के लिए AiHummer भी उजागर करता है कनेक्ट-आरपीसी HTTP पर सेवाएँ (सर्वर-स्ट्रीमिंग समर्थित है):

सेवा क्षेत्र
aihummer.health.v1 स्वास्थ्य जांच
aihummer.event.v1 घटना धारा
aihummer.conversation.v1 संवाद
aihummer.push.v1 पुश डिलीवरी
aihummer.media.v1 मीडिया ट्रांसफर
aihummer.turn.v1 घूमें निष्पादन

अगला कहाँ