SHAREAI के साथ निर्माण करें
एक अपॉइंटमेंट ऐप बनाएं जो ग्राहकों को ShareAI से जोड़ता है, उपयोगी AI एजेंडा तैयार करता है और उन्हें उनके AI खर्च पर नियंत्रण देता है।
अनुभव जो आप बनाएंगे
JamZY · अपॉइंटमेंट्सएक अपॉइंटमेंट चुनें। ShareAI कनेक्ट करें। एक योजना के साथ आएं।
आपका कार्यान्वयन
तीन ठोस डिलीवेरेबल्स: ग्राहक को कनेक्ट करें, उनकी अपॉइंटमेंट तैयार करें, और एकीकरण को सत्यापन के लिए तैयार करें।
एक ग्राहक अपने ShareAI खाते का चयन करता है, आपके ऐप को स्वीकृति देता है और JamZY पर लौटता है।
साइन इन करें, सत्र को रीफ्रेश करें और सफलतापूर्वक डिस्कनेक्ट करें।
एक अपॉइंटमेंट लक्ष्य को एक एजेंडा और सवालों में बदलें एक जानबूझकर AI अनुरोध के माध्यम से।
एक ड्राफ्ट जनरेट करें; एक अपॉइंटमेंट को सहेजने से कोई AI कॉल नहीं होती।
वैकल्पिक AI शुल्क समझाएं और प्लेटफ़ॉर्म चेक्स एकत्र करें जो आपकी समीक्षा सबमिशन के लिए आवश्यक हैं।
प्रत्येक शामिल प्लेटफ़ॉर्म और अनुरोधित स्कोप के पास रिकॉर्डेड चेक्स हैं।
इसे अपने एडिटर में ले जाएं
कार्यान्वयन लक्ष्य, आवश्यक इनपुट और स्वीकृति चेक्स के साथ पूरी गाइड कॉपी करें। कोड उदाहरण, टेबल और दस्तावेज़ लिंक को एक साथ रखें।
आपके प्रोजेक्ट के लिए तैयार, जिस प्रारूप में आपको आवश्यकता है।
अद्यतनित
आप एक ऐसा कनेक्शन बनाएंगे जिसे आपके ग्राहक समझ सकते हैं: उनका ShareAI खाता, एक वैकल्पिक AI तैयारी ड्राफ्ट, और उनकी अपॉइंटमेंट पर वापस जाने का एक स्पष्ट मार्ग।
जहां आप काम करेंगे आपका तैयार उदाहरण
अपने एप्लिकेशन को ShareAI Builder से कनेक्ट करें, नामांकन से लेकर समीक्षा के लिए तैयार एक परीक्षण इंटीग्रेशन तक। यह वॉकथ्रू JamZY का उपयोग करता है, जो एक छोटा Node.js अपॉइंटमेंट एप्लिकेशन है, प्रत्येक चरण दिखाने के लिए: ऐप को रजिस्टर करें, इसके वेब प्लेटफ़ॉर्म को कॉन्फ़िगर करें, ग्राहक के ShareAI खाते को कनेक्ट करें और एक अधिकृत AI अनुरोध भेजें। अपने उत्पाद पर भी यही चरण लागू करें।
| क्षमता | ग्राहक किससे सहमत होता है | JamZY क्या प्रदर्शित करता है |
|---|---|---|
| ShareAI के साथ लॉगिन करें | एक खाता कनेक्शन और वह पहचान जानकारी जो आपका ऐप अनुरोध करता है। | प्रमाणीकृत उपयोगकर्ता जानकारी से एक निजी ग्राहक पहचान। |
| ShareAI के साथ भुगतान करें · AI उपयोग | अधिकृत अनुमान के लिए ग्राहक के चयनित व्यक्तिगत या संगठन खाते का उपयोग करना। | उस खाते के पात्र क्रेडिट द्वारा वित्तपोषित एक अपॉइंटमेंट तैयारी ड्राफ्ट। |
| Builder मार्कअप | स्वीकृत एप्लिकेशन अनुबंध में अतिरिक्त AI उपयोग शुल्क। | अनुमोदन और अनुबंध प्रकाशन के बाद वैकल्पिक उपयोग मुद्रीकरण। |
| उत्पाद भुगतान | एक विशेष खरीदारी जो एक अलग ShareAI चेकआउट में प्रस्तुत की गई है। | एक विस्तार जो समझाया गया है भुगतान वॉकथ्रू। अपॉइंटमेंट डेमो चेकआउट को लागू नहीं करता है। |
एक ShareAI खाता, उस व्यक्तिगत या संगठन खाते का उपयोग करने की अनुमति जो ऐप का मालिक होगा, एक सार्वजनिक HTTPS कॉलबैक, एक लोगो, और काम करने वाले गोपनीयता, शर्तें और खाता-हटाने वाले पृष्ठ। उदाहरण चलाने के लिए, Node.js 22 या नया और आपके एप्लिकेशन के लिए एक HTTPS पता उपयोग करें।
स्क्रीनशॉट्स उदाहरण एप्लिकेशन विवरण का उपयोग करते हैं। ShareAI इस गाइड में दिए गए पते प्रोडक्शन पते हैं। तैयारी उत्पन्न करना एक वास्तविक AI अनुरोध करता है और क्रेडिट खर्च कर सकता है; डेमो अपॉइंटमेंट का चयन या सहेजना ऐसा नहीं करता। सत्यापन जांच आपके अपने सफल एकीकरण परीक्षणों द्वारा पूरी की जाती है।
आप खाता लॉगिन, AI खपत, वैकल्पिक अधिभार और एक पुष्टि किए गए उत्पाद खरीद को अलग कर सकते हैं। इस गाइड को पढ़ने के लिए भुगतान किए गए अनुरोध की आवश्यकता नहीं है।
आप वह Builder पहचान बनाएंगे जो आपके एप्लिकेशन और उसके ग्राहक संबंधों का मालिक होगा।
जहां आप काम करेंगे कंसोल → Builder Program
Builder Program इच्छित स्वामी के लिए खुलता है और New app प्रदान करता है। नामांकन निर्णय, एप्लिकेशन समीक्षा, सार्वजनिक जानकारी समीक्षा और Monetization Gateway अनुमोदन अलग-अलग चरण हैं।
आप JamZY को उसका अपना एप्लिकेशन रिकॉर्ड देंगे, ताकि उसकी पहचान, पहुंच और व्यावसायिक शर्तें एक साथ रहें।
जहां आप काम करेंगे Builder Program → उत्पाद → नया ऐप
एप्लिकेशन प्रोफ़ाइल के लिए एक सुलभ सार्वजनिक वेबसाइट का उपयोग करें। एक निजी या केवल-स्थानीय वेबसाइट सत्यापन में विफल हो सकती है, भले ही आपका विकास कॉलबैक सही तरीके से पंजीकृत हो। नया एप्लिकेशन एक ड्राफ्ट के रूप में शुरू होता है। आप इसे सार्वजनिक किए बिना संपादन जारी रख सकते हैं। इसका एप्लिकेशन पहचानकर्ता OAuth क्लाइंट ID या सब्सक्रिप्शन ID से अलग है।
JamZY इच्छित मालिक के लिए Product के अंतर्गत दिखाई देता है। प्रत्येक डिवाइस प्लेटफ़ॉर्म के लिए एक अतिरिक्त एप्लिकेशन न बनाएं।
आपको OAuth विकल्प मिलेंगे जो इस पर निर्भर करते हैं कि आपका ऐप कहां चलता है और इसके क्रेडेंशियल्स को कौन नियंत्रित करता है।
जहां आप काम करेंगे नया ऐप → एप्लिकेशन सेटअप
यदि आप JamZY डिप्लॉयमेंट को स्वयं संचालित करते हैं, तो उस मूल्य निर्धारण मॉडल का चयन करें जो आपके ऑफ़रिंग से मेल खाता हो, SaaS, वेंडर-होस्टेड क्लाउड ऐप, ग्राहक अपने स्वयं के उपभोग के लिए भुगतान करता है, और ShareAI एआई अनुरोधों के लिए। ये उदाहरण उत्तर हैं, हर उत्पाद के लिए आवश्यक नहीं।
| जहां ऐप चलता है | OAuth विकल्प | जहां क्रेडेंशियल्स रहते हैं |
|---|---|---|
| आपका होस्टेड बैकएंड | वेब सर्वर क्लाइंट क्लाइंट सीक्रेट का उपयोग कर सकता है। PKCE अभी भी लागू होता है। | सीक्रेट और टोकन आपके सर्वर पर रहते हैं। |
| ब्राउज़र एप्लिकेशन / SPA | सार्वजनिक वेब क्लाइंट PKCE के साथ। | कोई एम्बेडेड क्लाइंट सीक्रेट नहीं। उपयुक्त ब्राउज़र या बैकएंड सत्र डिज़ाइन का उपयोग करें। |
| सेल्फ-होस्टेड या हाइब्रिड वितरण | ऑनबोर्डिंग नीति के तहत PKCE के साथ सार्वजनिक क्लाइंट। | ग्राहक इंस्टॉलेशन के लिए साझा वेंडर सीक्रेट वितरित न करें। |
| Windows, macOS, Linux, Android या iOS | प्रत्येक सक्षम प्लेटफ़ॉर्म के लिए एक सार्वजनिक क्लाइंट। | PKCE और प्लेटफ़ॉर्म-उपयुक्त सुरक्षित स्टोरेज; कोई बंडल किया हुआ सीक्रेट नहीं। |
डाउनलोड करने योग्य JamZY नमूना जानबूझकर PKCE के साथ एक सार्वजनिक वेब क्लाइंट का उपयोग करता है, भले ही इसमें एक छोटा बैकएंड हो। सर्वर ब्राउज़र स्टोरेज से टोकन को बाहर रखता है। एक वेंडर-होस्टेड उत्तर सर्वर क्लाइंट की अनुमति देता है; यह आपको इसे चुनने के लिए बाध्य नहीं करता।
आप सहेजे गए उत्तरों को एप्लिकेशन जानकारी → एप्लिकेशन सेटअप के तहत फिर से देख सकते हैं। डिप्लॉयमेंट में बदलाव असंगत क्लाइंट सीक्रेट्स को हटा सकते हैं और पुन: सत्यापन की आवश्यकता हो सकती है। सहेजने से पहले उस प्रभाव की समीक्षा करें।
सहेजा गया डिप्लॉयमेंट आपकी वास्तविक आर्किटेक्चर का वर्णन करता है। क्लाइंट-सीक्रेट विकल्प उस उत्तर का अनुसरण करता है; एक अक्षम विकल्प नीति का स्पष्टीकरण है, न कि एक गायब क्रेडेंशियल।
आप ग्राहकों को वे उत्पाद विवरण और नीतियां देंगे जिनकी उन्हें कनेक्ट करने का निर्णय लेने से पहले आवश्यकता है।
जहां आप काम करेंगे एप्लिकेशन जानकारी
डैशबोर्ड के बाद एप्लिकेशन जानकारी खोलें। समर्पित अनुभागों के माध्यम से काम करें: विवरण, एप्लिकेशन सेटअप, प्रस्तुति, ब्रांडिंग, गैलरी और समीक्षा। उत्पाद को एक उपयोगी विवरण, एक सटीक वेबसाइट और ग्राहक वर्कफ़्लो के स्पष्ट स्क्रीनशॉट दें।
अपनी खुद की ऐप पहचान का उपयोग करें। ShareAI ब्रांडिंग एकीकरण बटन और व्याख्यात्मक सामग्री पर होनी चाहिए; यह आपके उत्पाद लोगो को प्रतिस्थापित नहीं करना चाहिए। गोपनीयता, शर्तें और विलोपन लिंक को साइन इन किए बिना पहुंच योग्य रखें।
जब फ्लोटिंग सेव एक्शन दिखाई दे, तो परिवर्तन सहेजें। सार्वजनिक जानकारी प्रस्ताव की अपनी समीक्षा होती है; स्वीकृत प्रस्ताव को संपादित करना लाइव सार्वजनिक प्रस्तुति को चुपचाप प्रतिस्थापित नहीं करता।
एक आगंतुक समझ सकता है कि JamZY क्या करता है, इसे कौन संचालित करता है, और विलोपन का अनुरोध कैसे करें। सार्वजनिक विवरण और कॉलबैक कॉन्फ़िगरेशन एक ही उत्पाद का संदर्भ देते हैं।
आप उस एक्सेस के लिए अनुरोध करेंगे जिसे आपका अपॉइंटमेंट अनुभव वास्तव में उपयोग करता है और इसके बिलिंग उद्देश्य को स्पष्ट करेंगे।
जहां आप काम करेंगे एप्लिकेशन → उपयोग के मामले
उपयोग मामलों में, खाता कनेक्शन के लिए ShareAI के साथ लॉगिन सक्षम करें और उस ग्राहक-वित्त पोषित प्रवाह के लिए Pay with ShareAI सक्षम करें जिसे आप समर्थन करना चाहते हैं। केवल तभी Monetization Gateway एक्सेस का अनुरोध करें जब आपका उत्पाद AI उपयोग पर अतिरिक्त शुल्क अर्जित करेगा। कंसोल में दिखाए गए अनुमोदन स्थिति का पालन करें।
| स्कोप | आप इसका अनुरोध क्यों करेंगे |
|---|---|
openid | इसके क्लाइंट-स्कोप्ड पहचान का उपयोग करके एक खाता कनेक्ट करें। |
profile / email | प्रोफ़ाइल या ईमेल क्लेम्स का अनुरोध केवल तभी करें जब आपके उत्पाद को उनकी आवश्यकता हो। |
inference | एप्लिकेशन कॉन्फ़िगरेशन द्वारा अनुमति मिलने पर समर्थित AI इंफरेंस एंडपॉइंट्स को कॉल करें। |
monetization_gateway | AI बिलिंग समझौते का उपयोग करें जिसे ग्राहक ने अधिभारित इंफरेंस के लिए स्वीकार किया है। |
payments | ग्राहक भुगतान अनुरोध बनाएं और निरीक्षण करें। प्रत्येक खरीदारी को अभी भी पुष्टि की आवश्यकता होती है। |
JamZY अनुरोध openid profile inference monetization_gatewayयह अनुरोध नहीं करता है payments और चेकआउट के माध्यम से कोई उत्पाद नहीं बेचता है। कंसोल में एक क्षमता सक्षम करना मौजूदा एक्सेस टोकन को इसे प्रदान नहीं करता है: ग्राहक को स्कोप्स और शर्तों को अधिकृत करना होगा।
क्षमताएं, कॉन्फ़िगर किए गए स्कोप्स और प्राधिकरण अनुरोध सहमत हैं। वैकल्पिक एक्सेस का अनुरोध करने से बचें जिसे आपका ऐप कभी उपयोग नहीं करता है या सत्यापित नहीं कर सकता।
आप ब्राउज़र-आधारित JamZY अनुभव के लिए एक वेब क्लाइंट बनाएंगे, सही प्रमाणीकरण विधि के साथ।
जहां आप काम करेंगे OAuth सेटिंग्स → वेब
विभिन्न प्लेटफ़ॉर्म के पास अलग-अलग क्रेडेंशियल्स और कॉलबैक नियम होते हैं। वे अलग-अलग उत्पाद नहीं हैं: सदस्यताएं और ग्राहक प्रबंधन एप्लिकेशन के लिए समेकित होते हैं। एप्लिकेशन परीक्षक प्लेटफ़ॉर्म्स में साझा किए जाते हैं, जिसमें लंबित निमंत्रण सहित अधिकतम पांच स्थान होते हैं; मालिक परीक्षक स्थान का उपभोग नहीं करता।
ठीक एक वेब प्लेटफ़ॉर्म मौजूद है। मूल प्लेटफ़ॉर्म जिन्हें आपने कॉन्फ़िगर नहीं किया है, वे आपके लॉन्च को अवरुद्ध नहीं करते।
प्राधिकरण के बाद, आप अपने ग्राहकों को अपनी एप्लिकेशन पर वापस लाएंगे, एक सटीक callback का उपयोग करते हुए जो आपका है।
जहां आप काम करेंगे वेब → कॉन्फ़िगरेशन
वेब → कॉन्फ़िगरेशन में, उस सटीक HTTPS callback को पंजीकृत करें जिसे आपकी एप्लिकेशन संभालती है। यह गाइड https://jamzy.example/oauth/callback एक उदाहरण के रूप में उपयोग करता है। इसे बदलें jamzy.example उस HTTPS डोमेन से, जहां आप JamZY की अपनी कॉपी को तैनात करते हैं, और उसी callback का उपयोग अपनी एप्लिकेशन कॉन्फ़िगरेशन में करें।
सहमति-स्क्रीन नाम, शर्तें, गोपनीयता और विलोपन जानकारी प्रदान करें। केवल उन्हीं स्कोप्स को सक्षम करें जिनकी आपको आवश्यकता है, फिर सहेजें। स्कीम, होस्ट, पथ और लागू क्वेरी विवरण प्राधिकरण अनुरोध और कोड एक्सचेंज से मेल खाने चाहिए। वाइल्डकार्ड या URL फ्रैगमेंट का उपयोग न करें।
| प्लेटफ़ॉर्म | लागू करने के लिए कॉलबैक |
|---|---|
| वेब | आपके एप्लिकेशन पर सटीक HTTPS पता। |
| एंड्रॉइड | एप्लिकेशन आईडी से मेल खाने वाली रिवर्स-डोमेन ऐप स्कीम, या पैकेज और SHA-256 साइनिंग फिंगरप्रिंट के साथ सत्यापित HTTPS ऐप लिंक। |
| iOS | मेल खाने वाली ऐप स्कीम, या बंडल आईडी और Apple App ID प्रीफिक्स के साथ सत्यापित HTTPS यूनिवर्सल लिंक। |
| विंडोज / macOS / लिनक्स | अनुमत सटीक HTTPS कॉलबैक, मेल खाने वाली रिवर्स-डोमेन एप्लिकेशन स्कीम, या 127.0.0.1 / [::1] पर समर्थित लूपबैक रीडायरेक्ट। लूपबैक पोर्ट भिन्न हो सकता है। |
इंस्टॉल किए गए ऐप्स सिस्टम ब्राउज़र में अधिकृत करते हैं और पंजीकृत कॉलबैक के माध्यम से लौटते हैं। दावा किए गए HTTPS ऐप लिंक के लिए, आवश्यक एसोसिएशन फ़ाइल प्रकाशित करें और कंसोल में एसोसिएशन सत्यापन चलाएं। एक फॉर्म में संभावित दिखने वाला कॉलबैक यह प्रमाण नहीं है कि आपका इंस्टॉल किया गया ऐप इसे प्राप्त करता है।
अधिकृत प्रवाह के माध्यम से कॉलबैक खोलना आपके ऐप पर लौटता है। एक रैंडम कोड या असंगत स्टेट को अस्वीकार कर दिया जाता है।
आपके पास अपॉइंटमेंट इंटरफ़ेस और इसका ShareAI कनेक्शन आपके स्वयं के एप्लिकेशन पहचानकर्ताओं के साथ चल रहा होगा।
जहां आप काम करेंगे आपका एप्लिकेशन → पर्यावरण कॉन्फ़िगरेशन
JamZY एक अपॉइंटमेंट एप्लिकेशन है जिसमें वैकल्पिक AI तैयारी सहायक है। इसका शेड्यूलर केवल ब्राउज़र-डेमो है: इसमें कोई कैलेंडर प्रदाता, ईमेल डिलीवरी या अपॉइंटमेंट भुगतान नहीं है। ShareAI प्राधिकरण और AI API एकीकरण वास्तविक कॉन्फ़िगर किए गए अपस्ट्रीम का उपयोग करते हैं।
डाउनलोड करें JamZY संदर्भ स्रोत। इसमें Node सर्वर, ब्राउज़र UI, परीक्षण और एक सेटअप README शामिल है; कोई प्रमाणपत्र, सीक्रेट्स, निर्भरताएँ या सत्र नहीं। उन्हें चलाने से पहले फ़ाइलों की समीक्षा करें। Node प्रक्रिया को सार्वजनिक मूल को संरक्षित करने वाले HTTPS रिवर्स प्रॉक्सी के पीछे रखें।
# .env — replace both identifiers with YOUR registered application.
JAMZY_PUBLIC_ORIGIN=https://jamzy.example
SHAREAI_CLIENT_ID=YOUR_WEB_CLIENT_ID
SHAREAI_APP_ID=YOUR_APPLICATION_UUID
SHAREAI_AUTH_ORIGIN=https://auth.shareai.now
SHAREAI_API_BASE_URL=https://api.shareai.now/api/v1
SHAREAI_SCOPES="openid profile inference monetization_gateway"
PORT=3443
BIND_HOST=127.0.0.1# Node 22+, behind your HTTPS reverse proxy
node --env-file=.env server.mjs
# Mocked upstream tests; these do not spend credits
node --test test/server.test.mjsअपना एप्लिकेशन बनाएं कंसोल.शेयरएआई.अब। इसका प्रोडक्शन क्लाइंट आईडी का उपयोग करें https://auth.shareai.now और https://api.shareai.now/api/v1। jamzy.example पता आपके ऐप के लिए एक प्लेसहोल्डर है, होस्टेड डेमो नहीं। अपने ऐप को HTTPS पर सर्व करें ताकि इसका सुरक्षित सत्र कुकी काम करे।
JamZY तुलना के लिए API-की कनेक्शन भी प्रदान करता है। यह वॉकथ्रू वॉलेट/OAuth बटन का उपयोग करता है। API की ग्राहक के JamZY OAuth समझौते को स्थापित नहीं करता है और ग्राहक प्राधिकरण प्रवाह के लिए प्रतिस्थापन नहीं है।
ऐप HTTPS के माध्यम से लोड होता है। इसका सार्वजनिक मूल, पंजीकृत कॉलबैक और क्लाइंट आईडी आपके पंजीकरण से मेल खाते हैं। कोई टोकन या सीक्रेट पेज स्रोत या लोकलस्टोरेज में दिखाई नहीं देता।
आप ग्राहक को उनके ShareAI खाते का चयन करने देंगे और आपके ऐप को आवश्यक पहुंच को स्वीकृति देंगे।
जहां आप काम करेंगे JamZY → अपने ShareAI वॉलेट से भुगतान करें
JamZY से, अपने ShareAI वॉलेट से भुगतान करें का चयन करें। ऐप ShareAI प्राधिकरण पृष्ठ खोलता है। ग्राहक साइन इन करता है, व्यक्तिगत या संगठन खाता चुनता है, ऐप और अनुरोधित पहुंच की जांच करता है, और लागू सदस्यता शर्तों को स्वीकार करता है।
const verifier = randomBytes(32).toString('base64url');
const state = randomBytes(32).toString('base64url');
const challenge = createHash('sha256').update(verifier).digest('base64url');
const authorize = new URL('https://auth.shareai.now/oauth/authorize');
authorize.search = new URLSearchParams({
client_id: clientId, response_type: 'code', redirect_uri: callback,
scope: 'openid profile inference monetization_gateway', state,
code_challenge: challenge, code_challenge_method: 'S256',
}).toString();
// Save state + verifier in the server session BEFORE redirecting.
// The downloadable server implements state expiry and one-time consumption.स्थानीय ग्राहक रिकॉर्ड को प्रमाणीकृत, क्लाइंट-स्कोप्ड sub और इसके जारीकर्ता/क्लाइंट संदर्भ द्वारा कुंजी करें। व्यक्तिगत और संगठन प्राधिकरण अलग-अलग भुगतान खाते चुन सकते हैं। ग्राहक ID एक वैश्विक उपयोगकर्ता ID, ईमेल पता या आंतरिक संगठन डेटाबेस ID नहीं है। प्लेटफार्मों के बीच पहचान को डिस्प्ले नामों को मिलाकर मर्ज न करें।
रद्द करें, असंगत स्टेट, पुनः उपयोग किए गए कोड और समाप्त प्राधिकरण सुरक्षित रूप से विफल होते हैं। सामान्य प्रवाह एक प्रमाणीकृत खाता लौटाता है बिना इसके टोकन को उजागर किए।
आप टोकन समाप्त होने पर अधिकृत अनुरोधों को काम करते रहेंगे, जबकि ग्राहक को डिस्कनेक्ट करने का एक विश्वसनीय तरीका देंगे।
जहां आप काम करेंगे आपका एप्लिकेशन → सत्र और टोकन हैंडलिंग
| क्रेडेंशियल | उद्देश्य | इसे कैसे संभालें |
|---|---|---|
| प्राधिकरण कोड | प्राधिकरण पृष्ठ से एक बार का हस्तांतरण। | एक बार एक्सचेंज करें, मिलान वेरिफायर और कॉलबैक का उपयोग करके। यह एक API टोकन नहीं है। |
| एक्सेस टोकन | स्वीकृत ग्रांट और स्कोप्स के भीतर API कॉल को अधिकृत करता है। | भेजें जैसे Authorization: Bearer …। समाप्ति और एंडपॉइंट प्राधिकरण त्रुटियों का सम्मान करें। |
| रिफ्रेश टोकन | एक और साइन-इन के बिना प्रतिस्थापन एक्सेस टोकन प्राप्त करता है जबकि ग्रांट मान्य रहता है। | सुरक्षित रूप से स्टोर करें। रिफ्रेश ऑपरेशन्स को सीरियलाइज़ करें और घुमाए गए क्रेडेंशियल्स को परमाणु रूप से बदलें। |
| ID टोकन | क्लाइंट के लिए एक OpenID Connect पहचान पुष्टि। | यदि आप इसका उपयोग करते हैं, तो हस्ताक्षर, जारीकर्ता, ऑडियंस, समाप्ति और नॉन्स को लागू रूप से मान्य करें। इसे एक अनुमानित Bearer टोकन के रूप में उपयोग न करें। |
| क्लाइंट सीक्रेट | एक अनुमत गोपनीय सर्वर क्लाइंट को प्रमाणीकृत करता है। | सर्वर पर स्टोर करें। यह सभी टोकन से अलग है और कभी भी सार्वजनिक क्लाइंट में बंडल नहीं किया जाता। |
# Public client refresh; run on a trusted terminal with scoped test credentials.
curl --fail-with-body 'https://auth.shareai.now/oauth/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=refresh_token' \
--data-urlencode "client_id=$SHAREAI_CLIENT_ID" \
--data-urlencode "refresh_token=$SHAREAI_REFRESH_TOKEN"लौटाए गए का उपयोग करें expires_in जीवनकाल का आविष्कार करने के बजाय। यदि रिफ्रेश एक प्रतिस्थापन रिफ्रेश टोकन लौटाता है, तो इसे नए एक्सेस टोकन के साथ एक अपडेट के रूप में बनाए रखें। प्रति सत्र एक रिफ्रेश को उड़ान में अनुमति दें ताकि समवर्ती अनुरोध घुमाए गए टोकन का पुनः उपयोग न करें। एक अमान्य या रद्द किया गया रिफ्रेश ग्रांट पुनः कनेक्शन की आवश्यकता होती है; अनिश्चित काल तक लूप न करें।
रिफ्रेशिंग एक स्कोप जोड़ नहीं सकता है या नए Monetization Gateway अनुबंध को चुपचाप स्वीकार नहीं कर सकता। नए अनुमतियों या शर्तों के लिए ग्राहक को फिर से प्राधिकरण प्रक्रिया से भेजें। JamZY केवल सर्वर मेमोरी में अधिकतम एक घंटे के डेमो सत्र के लिए क्रेडेंशियल्स संग्रहीत करता है, एक अप्रमाणित ID टोकन पर भरोसा करने के बजाय उपयोगकर्ता जानकारी को प्रमाणित करता है, और एक सुरक्षित, HttpOnly, SameSite कुकी का उपयोग करता है। एक प्रोडक्शन सेवा को अपने स्वयं के टिकाऊ, संरक्षित सत्र डिज़ाइन की आवश्यकता होती है।
डिसकनेक्ट पर, जहां लागू हो वहां रिफ्रेश/एक्सेस क्रेडेंशियल्स को रद्द करें और एप्लिकेशन सत्र को साफ़ करें। केवल ब्राउज़र कुकी को साफ़ करना ShareAI ग्रांट को रद्द नहीं करता या एक भुगतान सदस्यता को रद्द नहीं करता। कोड्स, टोकन, सीक्रेट्स या व्यक्तिगत प्रॉम्प्ट सामग्री को लॉग करने से बचें।
समाप्ति एक नियंत्रित रिफ्रेश को ट्रिगर करती है; नए टोकन पुराने टोकन को बदलते हैं। डिसकनेक्ट एप्लिकेशन सत्र को साफ़ करता है और किसी भी रद्द करने की विफलता की रिपोर्ट करता है।
आप एक अपॉइंटमेंट लक्ष्य को एक एजेंडा और उपयोगी प्रश्नों में बदलेंगे, एक स्पष्ट ग्राहक-वित्त पोषित AI अनुरोध के साथ।
जहां आप काम करेंगे उपलब्ध मॉडल → JamZY → तैयार रहें
एप्लिकेशन में उपलब्ध मॉडल खोलें। उन मॉडलों और प्रदाताओं का चयन करें जो आपका उत्पाद पेश करेगा और कॉन्फ़िगरेशन सहेजें। यदि कैटलॉग लोड नहीं हो सकता है, तो आगे बढ़ने से पहले अपस्ट्रीम उपलब्धता त्रुटि को हल करें; OAuth क्लाइंट को बार-बार बदलने से इसे ठीक नहीं किया जा सकता।
JamZY केवल कनेक्शन के बाद अपना कैटलॉग लोड करता है। एक अनुमत टेक्स्ट मॉडल चुनें, एक छोटा अपॉइंटमेंट लक्ष्य दर्ज करें और जानबूझकर तैयारी उत्पन्न करें का चयन करें। चयनित खाता पात्र क्रेडिट और किसी भी आवश्यक स्वीकृत AI बिलिंग शर्तों की आवश्यकता है। एक तारीख चुनना, अपॉइंटमेंट की समीक्षा करना और इसे सहेजना कोई अनुमान अनुरोध नहीं भेजता।
curl --fail-with-body 'https://api.shareai.now/api/v1/chat/completions' \
-H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"model":"YOUR_ENABLED_MODEL_SLUG","messages":[{"role":"user","content":"Create a short agenda and three questions for a 15-minute appointment about planning a booking app."}],"stream":false,"max_tokens":192}'एक वास्तविक शेड्यूलिंग उत्पाद को सर्वर-साइड बुकिंग स्टोर, उपलब्धता जांच, समय-क्षेत्र हैंडलिंग, रद्दीकरण नीति और कैलेंडर या अधिसूचना एकीकरण की आवश्यकता होती है। ये ShareAI प्राधिकरण से अलग हैं। AI आउटपुट को एक प्रस्ताव के रूप में रखें; भविष्य की बुकिंग क्रिया को अपने एप्लिकेशन नियमों के माध्यम से मान्य करें।
अनुमत कैटलॉग द्वारा लौटाए गए मॉडल स्लग का उपयोग करें। वास्तविक प्रतिक्रिया अनुबंध को संभालें: JamZY ShareAI के मूल message.content लिफाफा और OpenAI-शैली choices[0].message.content6.। HTTP 200 एक अधूरी या नेस्टेड त्रुटि प्रतिक्रिया के साथ सफल उत्तर नहीं है।
खर्च सीमा या अपर्याप्त क्रेडिट प्रतिक्रिया पर, एक उपयोगी व्याख्या और प्रदान किए गए ग्राहक बिलिंग लिंक दिखाएं। चयनित खाता सुरक्षित रखें। इसकी सीमा को पार न करें, भुगतानकर्ता को चुपचाप स्विच न करें या चार्ज किए गए ऑपरेशन को लूप में पुनः प्रयास न करें।
तैयारी उत्पन्न करें एक उपयोगी एजेंडा और प्रश्न लौटाता है। अनुरोध अधिकृत ग्राहक और एप्लिकेशन को, चयनित मॉडल और स्वीकृत शर्तों के साथ, सौंपा गया है। AI ड्राफ्ट अपॉइंटमेंट बुक या बदल नहीं सकता।
आप अपनी अतिरिक्त AI शुल्क को एक सदस्यता प्रस्ताव में समझाएंगे और ग्राहकों द्वारा स्वीकार की जा सकने वाली शर्तों को प्रकाशित करेंगे।
जहां आप काम करेंगे एप्लिकेशन → सदस्यताएँ
यदि यह पहले से ही लागू प्रशासनिक नीति द्वारा अनुमोदित नहीं है, तो ऐप के उपयोग मामलों के माध्यम से Monetization Gateway एक्सेस का अनुरोध करें। प्रश्नावली को पूरा करें और इसकी स्थिति का पालन करें। अनुमोदन कॉन्फ़िगरेशन को सक्षम करता है; ग्राहक अनुमति और बिलिंग सहमति अलग रहती है।
केवल उदाहरण: 20% Builder मार्कअप €1.00 पर योग्य नेटवर्क लागत जोड़ता है €0.20। स्टैंडर्ड प्राइसिंग पर, ShareAI का 5% शुल्क केवल उस €0.20 मार्कअप पर लागू होता है, किसी भी बिल योग्य इवेंट इनजेशन से पहले। वास्तविक गणना के लिए लाइव एस्टीमेटर और स्वीकृत अनुबंध का उपयोग करें। इस प्रवाह में एक सब्सक्रिप्शन ऑफ़र एक AI बिलिंग समझौता है; खाता कनेक्शन अकेले एक निश्चित आवर्ती मूल्य को डेबिट नहीं करता है।
surcharge सेट करें।ShareAI सहमति स्क्रीन स्वीकृत शर्तों के लिए आधिकारिक है। JamZY का सार्वजनिक क्लाइंट उपयोगकर्ता जानकारी से स्वीकृत बिलिंग योजना का अनुमान नहीं लगा सकता है, इसलिए इसका कनेक्शन पैनल सक्रिय सदस्यता का दावा नहीं करता है या नियुक्ति के लिए कोई मूल्य नहीं बनाता है।
प्रस्ताव शुल्क की व्याख्या करता है; अनुबंध ग्राहक द्वारा स्वीकार किया जा सकता है। आप समझते हैं कि कौन से ग्राहक पुराने शर्तों पर बने रहते हैं और क्यों।
आप अपने आवेदन की समीक्षा के लिए सबमिट करने के लिए आवश्यक वास्तविक एंडपॉइंट और स्कोप जांच एकत्र करेंगे।
जहां आप काम करेंगे OAuth सेटिंग्स → परीक्षक और सत्यापन
OAuth सेटिंग्स खोलें → परीक्षक और पूरे एप्लिकेशन में पांच परीक्षकों को आमंत्रित करें। लंबित निमंत्रण एक स्थान का उपभोग करते हैं लेकिन पहुंच प्रदान नहीं करते; प्राप्तकर्ता को स्वीकार करना होगा। मालिक की पहुंच और आमंत्रित परीक्षक की पहुंच सार्वजनिक उत्पादन पहुंच से अलग है।
जिस प्लेटफॉर्म को आप प्रकाशित करना चाहते हैं, उसके लिए सत्यापन खोलें। आवश्यक एंडपॉइंट और प्रत्येक कॉन्फ़िगर किए गए स्कोप के लिए वास्तविक सफल कॉल पूरी करें। डिस्कवरी और साइनिंग कुंजियों की जांच करें; अधिकृत/कॉलबैक, कोड एक्सचेंज, रिफ्रेश, प्रमाणित उपयोगकर्ता जानकारी और रद्दीकरण का परीक्षण करें। गोपनीय क्लाइंट को लागू इंट्रोस्पेक्शन का भी परीक्षण करना चाहिए। मूल दावा किए गए HTTPS लिंक को एसोसिएशन सत्यापन की आवश्यकता होती है।
एक प्रोफ़ाइल/ईमेल स्कोप को इसके वास्तविक लौटाए गए दावों की आवश्यकता होती है; उस व्यक्तिगत परीक्षण खाते का उपयोग करें जहां ईमेल आवश्यक है। inference और monetization_gateway स्कोप को एक पूर्ण अधिकृत AI अनुरोध की आवश्यकता होती है। भुगतान को एक सफल स्कोप्ड पेमेंट API कॉल की आवश्यकता होती है। एक सामान्य सफल HTTP प्रतिक्रिया, ब्राउज़र स्क्रीनशॉट या मैनुअल चेकलिस्ट कंसोल के रिकॉर्ड किए गए चेक का स्थान नहीं लेती।
आपके पास एक अधूरी प्लेटफॉर्म के लिए तीन विकल्प हैं: इसे पूरा करें और सत्यापित करें, इसे प्रकाशन से बाहर करें ताकि यह केवल मालिक/परीक्षक तक सीमित रहे, या इसे हटा दें। ऐसे प्लेटफॉर्म को शामिल न करें जिसमें कॉलबैक या स्कोप का उपयोग न किया गया हो। कॉन्फ़िगरेशन परिवर्तन जांच को अमान्य कर सकते हैं, इसलिए अपनी अंतिम परिवर्तनों के बाद रिकॉर्ड की गई स्थिति को ताज़ा करें।
प्रत्येक शामिल प्लेटफॉर्म आवश्यक कॉन्फ़िगरेशन, एंडपॉइंट और स्कोप जांच को पूर्ण के रूप में दिखाता है। गाइड की व्यक्तिगत चेकलिस्ट केवल एक पढ़ने में सहायता है।
आप जानेंगे कि समीक्षा के लिए क्या तैयार है, प्रकाशन कैसे काम करता है और बाद में ग्राहक पहुंच को कहां से ट्रैक करें।
जहां आप काम करेंगे एप्लिकेशन → डैशबोर्ड
लॉन्च के बाद एक योग्य ग्राहक के साथ पूरे प्रवाह को फिर से आज़माएं: कनेक्ट करें, खाता और सहमति का निरीक्षण करें, एक छोटा अपॉइंटमेंट तैयारी ड्राफ्ट तैयार करें, सुरक्षित रूप से रिफ्रेश करें, बिलिंग विफलता को संभालें, फिर डिस्कनेक्ट करें। यह सत्यापित करें कि लाइव उपयोगकर्ता अनुभव काम करता है बजाय इसके कि सफल सेव को मान लें।
कॉलबैक असंगति: पंजीकृत URL और दोनों अनुरोध मानों की सटीक तुलना करें। अनधिकृत परीक्षक: निमंत्रण स्वीकृति और चयनित खाता पुष्टि करें। स्कोप या अनुबंध गायब: केवल सक्षम एक्सेस का अनुरोध करें और इसे स्वीकार करने के लिए पुनः कनेक्ट करें। कोई मॉडल नहीं: उपलब्ध मॉडल और प्रदाता प्रतिबंधों का निरीक्षण करें। रिफ्रेश विफलता: असफल स्थानीय सत्र को साफ़ करें और पुनः कनेक्ट करें। समीक्षा अवरुद्ध: एक और OAuth क्लाइंट बनाने के बजाय प्लेटफ़ॉर्म जांच का निरीक्षण करें।
ऐप इच्छित ग्राहक के लिए काम करता है, रिकॉर्ड की गई जांच इसके प्रकाशन स्थिति का समर्थन करती है, और ग्राहक प्राधिकरण को नियंत्रित या रद्द कर सकता है।
आवेदन करने से पहले उस व्यक्तिगत या संगठन खाते का चयन करें जो प्रोग्राम नामांकन का स्वामी होगा। संगठन सत्यापन से पहले आवेदन जमा कर सकते हैं, लेकिन केवल स्टाफ अनुमोदन से पहुंच सक्रिय नहीं होती। Console में ऑनबोर्डिंग चेकलिस्ट से संगठन ईमेल और कंपनी सत्यापन पूरा करें। अनुमोदित संगठन तब तक Pending verification में रहता है जब तक दोनों जांच पूरी नहीं हो जाती। Builder, Provider और Creator प्रोग्राम इस नियम का पालन करते हैं।
Monetization Gateway मूल्य निर्धारण देखें · अन्वेषण करें ShareAI for Startups · स्कोप और अनुमतियां
आपके सार्वजनिक Terms & Conditions, Privacy Policy और deletion निर्देशों को आवेदन से मेल खाना चाहिए और बिना साइन-इन के उपलब्ध रहना चाहिए। ShareAI प्रोग्राम स्वीकृति, Monetization Gateway अनुमोदन, ग्राहक की OAuth अनुमति और स्वीकृत बिलिंग अनुबंध अलग-अलग निर्णय हैं। Refresh नई अनुमतियाँ जोड़ नहीं सकता या नए व्यावसायिक शर्तों को स्वीकार नहीं कर सकता।
मौजूदा एकीकरणों के लिए पुरानी surcharge स्कोप स्वीकार की जाती है। नए उदाहरण monetization_gateway का उपयोग करते हैं। मौजूदा वायर फ़ील्ड जैसे surcharge_bps और surcharge_percentage को अपरिवर्तित रखें।
Monetization Gateway मूल्य निर्धारण देखें · अन्वेषण करें ShareAI for Startups · स्कोप और अनुमतियां
मानक शुल्क 5% Builder मार्कअप का है। AI नेटवर्क लागत के €2.00 और 10% मार्कअप के लिए, ग्राहक €2.20 का भुगतान करता है। ShareAI €0.01 €0.20 मार्कअप प्राप्त करता है; Builder के पास Event Ingestion से पहले €0.19 है।
पहले 1,000 निपटाए गए Production Monetization Gateway अनुरोध प्रत्येक कैलेंडर माह (UTC) में मुफ्त हैं, जो Builder खाते में साझा किए जाते हैं। अतिरिक्त अनुरोधों की लागत €0.04 प्रति 1,000 होती है, पात्र छूट से पहले। एक निपटाया गया अनुरोध एक घटना बनाता है।
Pay with ShareAI अपने आप में, केवल inference एक्सेस, साधारण खाता API कुंजियाँ और Staging या परीक्षण ट्रैफ़िक Monetization Gateway Event Ingestion को लागू नहीं करते।
ShareAI for Startups स्वीकृत एप्लिकेशन पर वास्तविक ShareAI शुल्क के लिए एक साझा मासिक भत्ता प्रदान करता है। वर्तमान लॉन्च, ग्रोथ और मोमेंटम टियर €1,000, €5,000 और €10,000 प्रति माह सूचीबद्ध करते हैं। वही बजट ShareAI के प्रतिशत शुल्क को Builder मार्कअप और बिल योग्य इवेंट इनजेशन के साथ कवर करता है। यह एक सकल-मार्कअप भत्ता, एक अलग मुफ्त-इवेंट कोटा या मुफ्त AI inference नहीं है। खाते के पहले 1,000 मुफ्त इवेंट इसे उपभोग नहीं करते।
शेष इवेंट इनजेशन शुल्क अनुरोध के नए Builder आय से भुगतान किए जाते हैं, फिर उपलब्ध Builder AI आय और अप्रतिबंधित AI क्रेडिट्स से। ग्राहक AI शुल्क और उत्पाद payments अलग रहते हैं।
ShareAI एक निश्चित अवधि के लिए या जब तक बदला न जाए, एप्लिकेशन-विशिष्ट शुल्क या शुल्क समर्थन को स्वीकृत कर सकता है। एप्लिकेशन की वर्तमान मूल्य निर्धारण और विशेष कार्यक्रमों की स्वीकृत शर्तों, वैधता और उपभोग किए गए भत्ते की समीक्षा कंसोल में करें। एक टियर परिवर्तन या मूल्य निर्धारण ओवरराइड एप्लिकेशन के मासिक उपयोग को रीसेट नहीं करता।
लॉन्च ShareAI के साथ लॉग इन को वैकल्पिक रखता है। ग्रोथ और मोमेंटम इसे आवश्यक बनाते हैं; मोमेंटम को एप्लिकेशन फुटर में आधिकारिक ShareAI for Startups बैज की भी आवश्यकता होती है। ShareAI साप्ताहिक रूप से बैज की जांच करता है। आवश्यकताओं को बायपास करने के पुष्ट प्रयासों से डिमोशन, स्टार्टअप प्रोग्राम से हटाने या स्वीकृत प्रोग्राम शर्तों के तहत मार्केटप्लेस से वापसी हो सकती है।
एंटरप्राइज़ दरें ShareAI टीम द्वारा Builder खाते के लिए एक व्यक्तिगत प्रस्ताव पर सहमति के बाद कॉन्फ़िगर की जाती हैं। आवंटित प्रतिशत और इवेंट दर भविष्य के अनुरोधों पर लागू होती है।
Monetization Gateway मूल्य निर्धारण देखें · अन्वेषण करें ShareAI for Startups · स्कोप और अनुमतियां