रेसिपी
यह पेज अंग्रेज़ी से अनुवादित है। अगर दोनों में अंतर हो, तो अंग्रेज़ी पेज सही है। अंग्रेज़ी पेज पढ़ें
रेसिपी एक ऐसा कनेक्शन है जिसका नाम उस काम पर रखा गया है जो आप करना चाहते हैं। “बनाना शुरू करें” दबाने के बाद आप ऐप्स और कनेक्शन पर, “एक कनेक्शन बनाएं” के नीचे, एक रेसिपी चुनते हैं। इसके बाद विज़ार्ड अपने चरण एक-एक करके दिखाता है, और आगे बढ़ते समय हर चरण सहेजा जाता है, इसलिए आप बीच में छोड़कर बाद में लौट सकते हैं। जो रेसिपी ऐप आपको नहीं दिखाता, वह अभी आपके खाते पर उपलब्ध नहीं है।
हर रेसिपी एक जैसे दो चरणों पर खत्म होती है, “जांच” और “लागू करें”। टेस्ट, ड्राई-रन और लागू करना उनके बारे में बताता है।
मेरे सर्वर को Lingara को कॉल करने दें
आपके सर्वर को अपना साइन-इन और पासवर्ड मिलता है, ताकि वह आपकी ओर से Lingara का इस्तेमाल कर सके।
- बनाती है: आपके सर्वर के लिए एक साइन-इन (OAuth क्लाइंट), और उस साइन-इन के लिए एक पासवर्ड (क्लाइंट सीक्रेट)।
- चरण: “नाम और क्षमताएं”, “जांच”, “लागू करें”।
- उसके बाद: आपका सर्वर उस साइन-इन और उसके पासवर्ड से साइन इन करता है, और फिर उन क्षमताओं के साथ Lingara को कॉल करता है जो आपने उसे “यह क्या कर सकता है” में दी थीं।
साइन-इन चरण के लिए एक वैकल्पिक स्क्रिप्ट, जो आपके लिखे नाम को रखती है और उसे आपके सर्वर का बताती है:
return lingara.client({ name: input.name + ' (server)', scopes: input.scopes })पाठ योजना तैयार होने पर मेरे सर्वर को बताएं
हर बार जब आपकी कोई पाठ योजना तैयार होती है, Lingara आपके सर्वर को एक संदेश भेजता है।
- बनाती है: आपके सर्वर के लिए एक साइन-इन, उस साइन-इन के लिए एक पासवर्ड, और आपके सर्वर को संदेश (Webhook एंडपॉइंट)।
- चरण: “नाम और क्षमताएं”, “कहां भेजना है”, “जांच”, “लागू करें”।
- उसके बाद: आपके सर्वर को
lesson_plan.readyउसhttps://पते पर मिलता है जो आपने दिया था। हर संदेश हस्ताक्षरित होता है: लागू करने के बाद दिखाए गए पासवर्ड में से एक वह है जिससे आपका सर्वर जांचता है कि कोई संदेश सच में Lingara से आया है।
“कहां भेजना है” चरण के लिए एक वैकल्पिक स्क्रिप्ट, जो वह संदेश भी माँगती है जो किसी पाठ योजना के न बन पाने पर भेजा जाता है:
return lingara.webhook({ client: input.client, url: input.url, events: [...input.events, 'lesson_plan.failed'] })Lingara के अंदर एक कार्ड दिखाएं
आपका ऐप आपके होम या पाठ योजनाएँ पेज पर एक कार्ड दिखाता है।
- बनाती है: आपके सर्वर के लिए एक साइन-इन, और Lingara के अंदर एक कार्ड (ऐप मेनिफ़ेस्ट)।
- चरण: “नाम और क्षमताएं”, “आपका कार्ड”, “जांच”, “लागू करें”।
- उसके बाद: Lingara आपके द्वारा “जहां आपका ऐप कार्ड दिखाता है” में दिए गए पते से कार्ड माँगता है, और आपका ऐप उसे लौटाता है। लागू करने के बाद दिखाए गए पासवर्ड में से एक वह है जिससे आपका ऐप जांचता है कि कोई अनुरोध सच में Lingara से आया है।
“आपका कार्ड” चरण के लिए एक वैकल्पिक स्क्रिप्ट, जो कार्ड को सिर्फ़ होम पेज के साइड कॉलम में दिखाती है:
return lingara.app({ client: input.client, manifest: lingara.manifest({ ...input.manifest, slots: ['home.side'] }) })