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

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

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

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

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

1. सेंडग्रिड में एक खाता बनाएं

नोटसेंडग्रिड सिर्फ मेरी पसंद है, जिसे मैंने कई कारणों से चुना है, जिनमें से मुख्य कारण यह है कि उनके पास Node.js के लिए तैयार SDK है। आप कोई अन्य मेलिंग सेवा चुन सकते हैं.

आगे बढ़ते हैं खाता पंजीकरण पृष्ठ पर और वहां रजिस्ट्रेशन फॉर्म भरें। फिर हम जाते हैं डैशबोर्ड , नेविगेशन पैनल में चयन करें ईमेल एपीआई -> एकीकरण गाइड, और मुख्य पैनल पर - वेब एपीआई और нажимаем кнопку चुनें. चित्र में सब कुछ वैसा ही है:

अगले चरण में हम चयन करते हैं Node.js:

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

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

2. कोड लिखना

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

इन - लाइन #8 मेरा ईमेल हार्डकोडेड है (और इसलिए शर्म से छिपा हुआ है) - कृपया अपना ईमेल बताएं। वास्तविक जीवन में, हमें सारा डेटा (सहित) प्राप्त होगा ईमेल) वस्तु से घटना. उदाहरण के लिए, यदि विधि पोस्ट एक ऑब्जेक्ट हमारे फ़ंक्शन पर भेजा जाता है उपयोगकर्ता फ़ील्ड (संपत्ति) के साथ ईमेल, इस फ़ील्ड का मान इस प्रकार प्राप्त किया जा सकता है:

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

और यदि ईमेल पता विधि का उपयोग करके फ़ंक्शन को पास कर दिया जाता है GET, उदाहरण के लिए: https://functions.yandexcloud.net/123abc?[email protected]
पैरामीटर मान ईमेल आप इसे इस प्रकार प्राप्त कर सकते हैं:

const email = event.queryStringParameters.email;

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

module.exports.handler = async function (event) {
  return {
   'statusCode': 200, 
   'body': JSON.stringify(event)
  };
};

आधिकारिक दस्तावेज़ीकरण में इस पर अधिक विस्तार से (लेकिन कम स्पष्ट रूप से) चर्चा की गई है यहां.

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

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

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

touch index.js
touch .env

फाइल मैं index.js ऊपर स्क्रीनशॉट में दिखाए गए कोड की 22 पंक्तियाँ लिखें (केवल पंक्ति में)। #8 अपना ईमेल बदलें), और फ़ाइल में .env - (बिना किसी उद्धरण या विराम चिह्न के) जोड़ी निर्दिष्ट करें - कुंजी नाम/मान APIजो हमें हाल ही में कंसोल में प्राप्त हुआ है 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, और इसमें कुंजी का नाम/मान इंगित करें API, जैसा कि ऊपर दिखाया गया है।

3. तैनाती

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

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

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

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

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

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

अब आप कंसोल पर वापस लौट सकते हैं SendGrid, और बटन दबाएं एकीकरण सत्यापित करें. सिस्टम अपने चैनलों के माध्यम से हर चीज़ की जाँच करेगा, और परिणामस्वरूप उसे इस तरह एक स्क्रीन लौटानी चाहिए:

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

4. दान

स्रोत: www.habr.com