פונקציות Yandex שולחות דואר

היום ניצור את מה שנקרא. פונקציית Yandex (שם רשמי פונקציות ענן של Yandex), ששיתף פעולה עם שירות הדיוור SendGrid ישלח "סבון" למשתמשים שישנים בשלווה (רק בצחוק - אני יודע שכולנו נגד דואר זבל).

אני גם מתנגד (אבל בלי קנאות) של שרתים מסורתיים, ותומך במה שנקרא. ללא שרת פתרונות (ללא שרת), כי אני לא אוהב (ואני לא ממש יודע איך) לנהל שרתים, ועוד יותר מזה, משלם על הזמן שהם לא נטענים. דבר נוסף הוא פונקציות. מישהו נותן להם שירות בלעדיי, ואני משלם רק על שיחות. בתחילת אוקטובר 2019 הציגה Yandex את שלה פונקציות ענן של Yandex - נראה שהוא הראשון בפדרציה הרוסית ללא שרת. ומה שנחמד במיוחד הוא שלכישוריה של אליס הם בדרך כלל חופשיים, אז הם נמצאים בראייה ההיקפית שלי מאז. אבל בואו נתחיל כבר.

בואו נדמיין את התרחיש הזה. היישום שלך (לדוגמה, המיומנות של אליס זכור ושכח שאגב, גם עובד עליו פונקציות Yandex) מזמין את המשתמש לקנות מוצר דיגיטלי, למשל, אפשרויות נוספות, והמשתמש מבצע תשלום. איזושהי מערכת תשלום (דומה באופן מבלבל ל Yandex.Money) מעבד את התשלום ושולח אותו לכתובת שאתה מספק (ויהיה לנו קישור להתקשרות פונקציות Yandex) HTTP- בקשה המכילה פרטי תשלום, כגון סכום, שם מלא, מספר טלפון ואימייל של המשלם. אנחנו רוצים לעבד את הנתונים האלה בדרך כלשהי, למשל: לבדוק את הסכום, לבצע ערכים מתאימים במסד הנתונים, לשלוח למשתמשים SMS и כתובת אימייל עם אישור על קבלת התשלום והנחיות נוספות. אז את עצמך שירות מיקרו.

על איך מ פונקציות Yandex לבצע ערכים במסד הנתונים ענן Firestore כבר הסתכלנו על זה במדריך אליס זוכרת הכל (ובעתיד, אני חושב, נשקול דוגמה למסד נתונים אחר - מסד הנתונים של Yandex). על איך לשלוח למשתמשים SMS ולשלב את האפליקציה שלנו עם Yandex.Money - נסדר את זה בעתיד הקרוב. עכשיו בואו רק נתמודד עם שליחת מכתבים.

1. צור חשבון ב- SendGrid

שים לבSendGrid היא רק הבחירה שלי, שעשיתי מכמה סיבות, והעיקרית היא שיש להם SDK מוכן עבור Node.js. אתה יכול לבחור כל שירות דיוור אחר.

בוא נמשיך הלאה לדף רישום החשבון ומלא את טופס ההרשמה שם. ואז אנחנו הולכים ל לוח ניהול חשבון, בחלונית הניווט בחר API של אימייל -> מדריך אינטגרציה, ובפאנל הראשי - ממשק API ולחץ על הכפתור בחרו. הכל כמו בתמונה:

בשלב הבא אנו בוחרים Node.js:

הבא אנחנו מגיעים עם עבור שלנו APIשם המפתח (יוצג רק בקונסולה ברשימת המפתחות, ואין לו שום קשר לקוד העתידי שלנו; הרגע הגעתי לקוד בלתי מתכלה הדגמה-API-key) ולחץ על הכפתור צור מפתח:

המפתח ייווצר, נעתיק אותו ונשמור עליו בביטחון העמוק ביותר. ויהיה לנו מסך עם כפתור אמת אינטגרציה, כמו בתמונה למטה, אבל עדיין לא נלחץ עליה, אבל בואו נעבור לכתיבת הקוד:

2. כתיבת קוד

אבל הקוד עצמו, כפי שאתה יכול לראות, קטן עד כדי גיחוך - 22 שורות!

בשורה #8 המייל שלי מקודד קשה (ולכן מוסתר בביישנות) - נא לציין את שלך. בחיים האמיתיים, נקבל את כל הנתונים (כולל אמייל) מאובייקט אירוע. למשל, אם השיטה POST אובייקט נשלח לפונקציה שלנו המשתמש עם שדה (נכס) אמייל, ניתן לקבל את הערך של שדה זה כך:

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

ואם כתובת המייל מועברת לפונקציה באמצעות השיטה לקבל, לדוגמה: https://functions.yandexcloud.net/123abc?[email protected]
ערך פרמטר אמייל אתה יכול להשיג את זה ככה:

const email = event.queryStringParameters.email;

כדי להסתכל מה בדיוק כלול בחפץ אירוע, אתה יכול ליצור את הפשוט ביותר פונקציית Yandex וסובב את זה עם שאילתות:

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

כאן נדרשת רק החבילה @sendgrid/mail. שקית פלסטיק מאמת אימייל בודק את תקפות כתובת המייל (איך לא ניחשתי מיד?), אבל אם אנחנו בטוחים בזה (זה כבר נבדק כבר הרבה זמן בלעדינו), אנחנו לא צריכים להתקין את זה (ושל כמובן, אנחנו לא צריכים לבדוק את זה בקוד). שקית פלסטיק dotenv נועד לקרוא רשומות מקובץ .v כמשתני זמן ריצה. אבל ב פונקציות Yandex אפשר למקם את המשתנים הללו ישירות בסביבת זמן הריצה. אֵיך? - אני אראה את זה למטה. לכן החבילה dotenv אתה גם לא יכול להתקין את זה ואת הקובץ .v - לא ליצור, ובמקביל הקוד נמצא בקובץ index.js אל תשתנה. אבל כאן התקנו את החבילה הזו, אז אנחנו יוצרים קבצים index.js и .v:

touch index.js
touch .env

בקובץ index.js כתוב 22 שורות קוד המוצגות בצילום המסך למעלה (רק בשורה #8 שנה את האימייל שלך), ובקובץ .v - (ללא כל מירכאות או סימני פיסוק) ציין את הזוג - שם/ערך מפתח APIשקיבלנו לאחרונה בקונסולה SendGrid:
SENDGRID_API_KEY=המפתח-המאוד-סודי-sendgrid-api-שלך

ואם אתה רוצה פחות עבודה, שיבט את המאגר והתקן את החבילות:

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

בקובץ index.js, בשורה #8 שנה כתובת אימייל; ליצור קובץ בספריית השורש .v, ובו ציינו את השם/ערך של המפתח API, כפי שמוצג לעיל.

3. פריסה

פחות או יותר ברור ומפורט אודות Yandex.Cloud ואיך למקם אותו שם פונקציות Yandex המתואר במאמר שלי אליס בארץ ביטריקס - אני שולח את הבורים לארץ הזאת, ולמען כל השאר (ואלה שחזרו) - אז ספר קומיקס קטן (כלומר סדרת תמונות וטקסט).

אנחנו יוצרים zip-ארכיון (בוא נקרא לזה, למשל, mailer.zip), שבה אנו כוללים את הספרייה צומת_מודולים וקבצים ‎.env, index.js - הכל מקטלוג הפרויקטים שלנו:

אנו יוצרים פונקציה עם השם... נכון - דואר, בתפריט הניווט השמאלי אנו נכנסים Редактор, מלא את השדות הנדרשים ועבור לכרטיסייה ארכיון ZIP להוריד את הארכיון שלנו mailer.zip:

והנה האפשרות שהוזכרה קודם להורדה מפתח API ישירות כאן, במקום ליצור קובץ בפרויקט .v, ואל תתקין את החבילה dotenv. אבל כבר עשינו את כל זה, אז אני מראה את זה רק למידע. כלומר, אין צורך לשכפל!

כעת, בפינה הימנית העליונה, לחץ על הכפתור צור גרסה, והמתן כמה שניות. כשהכל יהיה מוכן, נעבור אוטומטית למדור סקירה. שם נפעיל את האפשרות תפקיד ציבוריכך שתוכל לתקשר איתו מהעולם החיצון.

אתה רואה את הקישור הכחול מול הכיתוב קישור שיחה? לחץ עליו. ייפתח חלון דפדפן ריק... אבל רגע - קיבלתי מייל:

עכשיו אתה יכול לחזור לקונסולה SendGrid, ולחץ על הכפתור אמת אינטגרציה. המערכת תבדוק הכל דרך הערוצים שלה, וכתוצאה מכך היא אמורה להחזיר מסך כזה:

זהו, חבר'ה (ובנות, כמובן) - הכל באמת מאוד פשוט ואלגנטי! יהיו עוד מאמרים. אם מישהו מעוניין לקרוא משהו כזה, הירשמו כדי לא לפספס.

4. תרומות

מקור: www.habr.com