यैंडेक्स फ़ंक्शन मेल भेजते हैं

आज हम तथाकथित बनाएंगे यैंडेक्स फ़ंक्शन ( यैंडेक्स क्लाउड फ़ंक्शंस का आधिकारिक नाम), जो SendGrid मेलिंग सेवा के साथ साजिश करता है, शांतिपूर्वक सो रहे उपयोगकर्ताओं को "साबुन" भेजेगा ( बस मजाक कर रहा है - मुझे पता है कि हम सभी स्पैम के खिलाफ हैं)।

मैं पारंपरिक सर्वरों का विरोधी (लेकिन कट्टरता के बिना), और तथाकथित का समर्थक भी हूं सर्वर रहित (सर्वर रहित) समाधान, क्योंकि मुझे सर्वर को प्रशासित करने के लिए (और वास्तव में पता नहीं है) कैसे पसंद है, और इससे भी अधिक - उस समय के लिए भुगतान करने के लिए जब वे लोड नहीं होते हैं। कार्य एक और मामला है। कोई मेरे बिना उनकी सेवा करता है, और मैं केवल कॉल के लिए भुगतान करता हूं। अक्टूबर 2019 की शुरुआत में, यैंडेक्स ने अपना यैंडेक्स क्लाउड फ़ंक्शंस पेश किया - यह रूसी संघ में पहला सर्वर रहित लगता है। और विशेष रूप से अच्छा है - ऐलिस के कौशल के लिए वे आम तौर पर स्वतंत्र होते हैं, इसलिए वे तब से मेरी परिधीय दृष्टि के क्षेत्र में हैं। लेकिन शुरुआत करते हैं।

ऐसे परिदृश्य की कल्पना करें। आपका एप्लिकेशन (उदाहरण के लिए, ऐलिस रिमेम्बर एंड फॉरगेट स्किल, जो, यांडेक्स फ़ंक्शंस पर भी काम करता है) उपयोगकर्ता को डिजिटल सामान खरीदने के लिए ऑफ़र करता है, उदाहरण के लिए, अतिरिक्त विकल्प और उपयोगकर्ता भुगतान करता है। एक निश्चित भुगतान प्रणाली ( Yandex.Money के साथ भ्रम की डिग्री के समान) भुगतान की प्रक्रिया करती है, और इसे आपके द्वारा दिए गए पते पर भेजती है (और हमारे पास यैंडेक्स फ़ंक्शन को कॉल करने के लिए एक लिंक होगा) HTTP अनुरोध जिसमें भुगतान विवरण, जैसे कि राशि, नाम, फोन और भुगतानकर्ता ईमेल। लेकिन हम इस डेटा को किसी तरह से संसाधित करना चाहते हैं, उदाहरण के लिए: राशि की जांच करें, डेटाबेस में उचित प्रविष्टियां करें, भुगतान की रसीद और आगे के निर्देशों की पुष्टि के साथ उपयोगकर्ताओं को एसएमएस और ईमेल भेजें। इस तरह के एक microservice ।

ऐलिस ट्यूटोरियल में क्लाउड फायरस्टार डेटाबेस में यैंडेक्स फ़ंक्शन से रिकॉर्ड करने के तरीके के बारे में सब कुछ याद करता है (और भविष्य में, मुझे लगता है, हम एक और डेटाबेस के लिए एक उदाहरण पर विचार करेंगे - यांडेक्स डेटाबेस )। हम उपयोगकर्ताओं को एसएमएस भेजने और निकट भविष्य में Yandex.Money के साथ अपने एप्लिकेशन को एकीकृत करने के तरीके का विश्लेषण करेंगे। अब हम केवल पत्र भेजने का काम करेंगे।

1. SendGrid में एक खाता बनाएँ

हम खाता पंजीकरण पृष्ठ पर जाते हैं और वहां पंजीकरण फॉर्म भरते हैं। फिर डैशबोर्ड पर जाएं , नेविगेशन पैनल में ईमेल एपीआई -> एकीकरण गाइड , और मुख्य पैनल - वेब एपीआई पर क्लिक करें और चुनें बटन पर क्लिक करें। चित्र में सब कुछ जैसा है:



अगले चरण में, Node.js चुनें:



अगला, हम अपनी एपीआई कुंजी के लिए एक नाम के साथ आते हैं (यह केवल कुंजियों की सूची में कंसोल में प्रदर्शित किया जाएगा, और हमारे भविष्य के कोड से कोई लेना-देना नहीं है; मैं सिर्फ एक असंगत डेमो-एपीआई-कुंजी के साथ आया हूं) और कुंजी बटन बनाएं पर क्लिक करें:



कुंजी उत्पन्न होती है, हम इसे कॉपी करते हैं और इसे सबसे गहरी गोपनीयता में रखते हैं। और हमारे पास वेरिफ़िटी इंटीग्रेशन बटन के साथ एक स्क्रीन होगी, जैसा कि नीचे दी गई तस्वीर में है, लेकिन अब हम इसे नहीं दबाएंगे, लेकिन कोड लिखने के लिए आगे बढ़ें:

2. कोड लेखन

और कोड ही, जैसा कि आप देखते हैं, हास्यास्पद रूप से छोटा है - 22 लाइनें!



# 8 पंक्ति में , मेरा मेल एक हार्डकोड के साथ पंजीकृत है (और इसलिए शर्मीली रूप से कवर किया गया है) - आप अपना संकेत देते हैं। वास्तविक जीवन में, हम ईवेंट ऑब्जेक्ट से सभी डेटा प्राप्त करेंगे। उदाहरण के लिए, यदि POST ( "Content-Type": "application/json" ) विधि ईमेल क्षेत्र (संपत्ति) पास करती है:

 { ... "email": "user@example.com", ... } 

इस क्षेत्र का मूल्य निम्नानुसार प्राप्त किया जा सकता है:

 const body = JSON.parse(event.body); const email = body.email; 

और अगर ईमेल फ़ील्ड किसी अन्य फ़ील्ड की संपत्ति है - उपयोगकर्ता ऑब्जेक्ट (संग्रह):

 { ... "user": { ... "email": "user@example.com", ... }, ... } 

इस क्षेत्र का मूल्य और भी आसान हो सकता है:

 const { user } = event; const email = user.email; 

यदि URL में मेल पते को फ़ंक्शन (तथाकथित URL क्वेरी स्ट्रिंग ) में पारित किया जाता है, उदाहरण के लिए: https://functions.yandexcloud.net/123abc? email=user@example.com https://functions.yandexcloud.net/123abc? email=user@example.com
ईमेल पैरामीटर मान होगा:

 const email = event.queryStringParameters.email; 

ईवेंट ऑब्जेक्ट में वास्तव में क्या निहित है, इस पर एक नज़र डालने के लिए, आप एक साधारण यैंडेक्स फ़ंक्शन बना सकते हैं और इसे अनुरोधों के साथ मोड़ सकते हैं:

 module.exports.handler = async function (event) { return { 'statusCode': 200, 'headers': { 'Content-Type': 'application/json; charset=utf-8' }, 'body': JSON.stringify(event), 'isBase64Encoded': false }; }; 

अधिक (लेकिन कम समझदार) यह यहां आधिकारिक दस्तावेज में कहा गया है ।

इसलिए, प्रोजेक्ट डायरेक्टरी बनाएं (उदाहरण के लिए, मेलर ), उस पर जाएं, प्रोजेक्ट को इनिशियलाइज़ करें, निर्भरताएं स्थापित करें:

 mkdir mailer cd mailer npm init -y npm i @sendgrid/mail email-validator dotenv 

यहाँ, केवल @ sendgrid / mail पैकेज की आवश्यकता है । ईमेल-सत्यापनकर्ता पैकेज वैधता के लिए ईमेल पते की जांच करता है (जैसा कि मैंने तुरंत अनुमान नहीं लगाया था?), लेकिन अगर हम इसके बारे में सुनिश्चित हैं (यह लंबे समय तक हमारे बिना सत्यापित किया गया है), हम इसे स्थापित नहीं कर सकते (और, ज़ाहिर है, कोड की जांच नहीं करते हैं)। Dotenv पैकेज रनवे चर के रूप में .env फ़ाइल से प्रविष्टियों को पढ़ने के लिए डिज़ाइन किया गया है। लेकिन Yandex फ़ंक्शन में इन चर को सीधे निष्पादन वातावरण में डालने की क्षमता है। कैसे? - मैं इसे नीचे दिखाऊंगा। इसलिए, dotenv पैकेज भी स्थापित नहीं किया जा सकता है, और .env फ़ाइल नहीं बनाई जानी चाहिए , और index.js फ़ाइल में कोड नहीं बदला जाना चाहिए । लेकिन यहां हमने यह पैकेज स्थापित किया है, इसलिए हम index.js और .env फाइलें बनाते हैं:

 touch index.js touch .env 

Index.js फ़ाइल में, हम ऊपर दिखाए गए स्क्रीनशॉट में दिखाए गए कोड की 22 पंक्तियाँ लिखते हैं (केवल # 8 पंक्ति में मेल बदलें), और .env फ़ाइल में (बिना किसी उद्धरण चिह्न और विराम चिह्न के) एक जोड़ी निर्दिष्ट करें - एपीआई कुंजी का नाम / मान, जो। हमें हाल ही में SendGrid कंसोल में मिला है:
SENDGRID_API_KEY = आपका बहुत-गुप्त-प्रेषित-एपि-कुंजी

और यदि आप कम काम चाहते हैं, तो रिपॉजिटरी को क्लोन करें, पैकेजों को स्थापित करें:

 git clone https://github.com/stmike/ycf-sendgrid-mailer-tutorial.git cd ycf-sendgrid-mailer-tutorial npm i 

Index.js फ़ाइल में, लाइन # 8 पर, मेल बदलें; रूट डायरेक्टरी में .env फाइल बनाएं और इसमें एपीआई कुंजी का नाम / मान निर्दिष्ट करें, जैसा कि थोड़ा ऊपर दिखाया गया है।

3. तैनात

यांडेक्स के बारे में अधिक या कम स्पष्ट रूप से और विस्तार से और यैंडेक्स -फ़ंक्शंस को कैसे रखा जाए इसके बारे में मेरे लेख ऐलिस में बिट्रिक्स में वर्णित है - मैं इसे इस देश में अज्ञानी को भेजता हूं, और बाकी सभी (बाकी और जो लोग लौटते हैं) - इसके बाद एक छोटी सी कॉमिक (यानी) ई। चित्रों और पाठ की एक श्रृंखला)।

हम एक ज़िप आर्काइव बनाते हैं (उदाहरण के लिए, मेलर.ज़िप कहते हैं ), जिसमें हम नोड_मॉड्यूल्स डायरेक्टरी और .env, index.js फ़ाइलों को शामिल करते हैं - ये सभी हमारे प्रोजेक्ट की डायरेक्टरी से हैं:



हम नाम के साथ एक फ़ंक्शन बनाते हैं ... सही ढंग से - मेलर , बाएं नेविगेशन मेनू में संपादक का चयन करें, आवश्यक फ़ील्ड भरें, और ज़िप संग्रह टैब पर स्विच करें और हमारे मेलर को लोड करें। ज़िप संग्रह:



और यहां पहले से उल्लेखित एपीआई-कुंजी को सीधे डाउनलोड करने का अवसर दिया गया है, और प्रोजेक्ट में .env फ़ाइल नहीं बनाई गई है, और डॉटेनव पैकेज स्थापित नहीं किया गया है। लेकिन हम यह सब कर चुके हैं, इसलिए मैं इसे केवल जानकारी के लिए दिखा रहा हूं। वह है - नकल करने की कोई जरूरत नहीं है!



अब ऊपरी दाएं कोने में, संस्करण बनाएं बटन पर क्लिक करें, और कुछ सेकंड प्रतीक्षा करें। जब सब कुछ तैयार हो जाता है, तो हम स्वचालित रूप से अवलोकन अनुभाग पर जाएंगे। हम सार्वजनिक फ़ंक्शन विकल्प को सक्षम करेंगे ताकि आप बाहरी दुनिया से इसके साथ बातचीत कर सकें।



कॉल लिंक के बगल में नीला लिंक देखें? उसे क्लिक करें। एक खाली ब्राउज़र विंडो खुलेगी ... लेकिन प्रतीक्षा करें - मुझे एक पत्र मिला:



अब आप SendGrid कंसोल पर लौट सकते हैं, और सत्यापन एकीकरण बटन पर क्लिक कर सकते हैं। सिस्टम अपने चैनलों पर सब कुछ जांच करेगा, और परिणामस्वरूप ऐसी स्क्रीन वापस आनी चाहिए:



तो, दोस्तों (और लड़कियों, निश्चित रूप से) - सब कुछ वास्तव में बहुत सरल और सुरुचिपूर्ण है! अधिक लेख होंगे। यह पढ़ने के लिए दिलचस्प है, ताकि सदस्यता न छूटे। आप यहां या टेलीग्राम में सदस्यता ले सकते हैं।

4. डोनट्स