Функциите на Yandex изпращат поща

Днес ще създадем т.нар. Yandex функция (официално име Облачни функции на Yandex), който се е сговорил с пощенската услуга SendGrid ще изпрати „сапун“ на спокойно спящи потребители (шегувам се - знам, че всички сме против спама).

Аз също съм противник (но без фанатизъм) на традиционните сървъри, и привърженик на т.нар. без сървър (безсървърни) решения, защото не обичам (и наистина не знам как да) администрирам сървъри и още повече плащам за времето, когато не са заредени. Друго нещо са функциите. Някой ги обслужва без мен, а аз плащам само разговори. В началото на октомври 2019 г. Yandex представи своя Облачни функции на Yandex - изглежда е първият в Руската федерация без сървър. И това, което е особено хубаво е, че за уменията на Алис те обикновено са безплатни, така че оттогава са в моето периферно зрение. Но нека да започнем вече.

Нека си представим този сценарий. Вашето приложение (например умението на Алис Запомни и забрави който, между другото, също работи върху Функции на Yandex) предлага на потребителя да закупи цифров продукт, например допълнителни опции, и потребителят извършва плащане. Някакъв вид платежна система (объркващо подобна на Yandex) обработва плащането и го изпраща на посочения от вас адрес (и ние ще имаме връзка за обаждане Функции на Yandex) HTTP- заявка, съдържаща данни за плащане, като сума, трите имена, телефонен номер и имейл на платеца. Искаме да обработим тези данни по някакъв начин, например: да проверим сумата, да направим подходящи записи в базата данни, да изпратим на потребителите SMS и Имейл с потвърждение за получаване на плащането и допълнителни инструкции. Значи себе си микроуслуга.

За това как от Функции на Yandex правете записи в базата данни Cloud Firestore вече го разгледахме в урока Алис помни всичко (и в бъдеще, мисля, ще разгледаме пример за друга база данни - База данни Yandex). За това как да изпращате на потребителите SMS и интегрирайте нашето приложение с Yandex.Money — ще го оправим в близко бъдеще. Сега нека се заемем с изпращането на писма.

1. Създайте акаунт в SendGrid

ВниманиеSendGrid е просто моят избор, който направих поради няколко причини, като основната е, че имат готов SDK за Node.js. Можете да изберете всяка друга пощенска услуга.

Минаваме към страницата за регистрация на акаунта и попълнете регистрационния формуляр там. След това отиваме на Табло, в навигационния панел изберете Имейл API -> Ръководство за интегриране, а на основния панел - Уеб API и нажимаем бутона Изберете. Всичко е като на снимката:

В следващата стъпка избираме Node.js:

След това измисляме за нашите API-име на ключ (ще се показва само в конзолата в списъка с ключове и няма нищо общо с бъдещия ни код; току-що измислих непреходен демо-api-ключ) и натиснете бутона Създаване на ключ:

Ключът ще бъде генериран, ние ще го копираме и ще го пазим в най-голяма тайна. И ще имаме екран с бутон Проверете интеграцията, както е на снимката по-долу, но все още няма да щракваме върху него, а нека преминем към писане на кода:

2. Писане на код

Но самият код, както виждате, е смешно малък - 22 реда!

В редица #8 Моят имейл е твърдо кодиран (и следователно плахо скрит) - моля, посочете своя. В реалния живот ще получим всички данни (включително електронна поща) от обект събитие. Например, ако методът ПУСНИ към нашата функция се изпраща обект потребител с поле (имот) електронна поща, стойността на това поле може да се получи по следния начин:

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

И ако имейл адресът се предава на функцията с помощта на метода GET, например: 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/поща. Найлонов плик имейл-валидатор проверява имейл адреса за валидност (как не се досетих веднага?), но ако сме сигурни в него (вече е проверяван отдавна без нас), не е нужно да го инсталираме (и, на разбира се, не е нужно да го проверяваме в кода). Найлонов плик dotenv предназначен за четене на записи от файл .env като променливи по време на изпълнение. Но в Функции на Yandex Възможно е да поставите тези променливи директно в средата за изпълнение. как? - Ще го покажа по-долу. Следователно пакетът dotenv можете също да не го инсталирате и файла .env - не създавайте, а в същото време кодът е във файла index.js не се променят. Но тук сме инсталирали този пакет, така че създаваме файлове index.js и .env:

touch index.js
touch .env

Във файла index.js напишете 22 реда код, показан на екранната снимка по-горе (само в реда #8 променете своя имейл) и във файла .env - (без кавички или препинателни знаци) посочете двойката - име на ключ/стойност 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 смяна на имейл; създайте файл в основната директория .env, а в него посочете името/стойността на ключа API, както е показано точно по-горе.

3. Разположете

Повече или по-малко ясно и подробно за Yandex.Cloud и как да го поставим там Функции на Yandex описан в статията ми Алиса в страната на Битрикс - Изпращам невежите в тази страна, а за всички останали (и тези, които се върнаха) - тогава малък комикс (т.е. поредица от снимки и текст).

Създавайте цип-архив (да го наречем напр. mailer.zip), в който включваме директорията модули_възел и файлове .env, index.js - всичко от нашия каталог с проекти:

Създаваме функция с името... правилно - подател, в лявото навигационно меню влизаме Редактор, попълнете задължителните полета и преминете към раздела ZIP архив изтеглете нашия архив mailer.zip:

И тук е споменатата по-горе опция за изтегляне API ключ директно тук, вместо да създавате файл в проекта .env, и не инсталирайте пакета dotenv. Но вече сме направили всичко това, така че го показвам само за информация. Тоест няма нужда от дублиране!

Сега в горния десен ъгъл щракнете върху бутона Създаване на версияи изчакайте няколко секунди. Когато всичко е готово, автоматично ще отидем в секцията Преглед. Там ще активираме опцията обществена функциятака че да можете да взаимодействате с него от външния свят.

Виждате синята връзка срещу надписа Линк за обаждане? Кликнете върху него. Ще се отвори празен прозорец на браузъра... Но изчакайте - получих имейл:

Сега можете да се върнете към конзолата SendGrid, и натиснете бутона Проверете интеграцията. Системата ще провери всичко по своите канали и в резултат на това трябва да върне екран като този:

Това е всичко, момчета (и момичета, разбира се) - всичко е наистина много просто и елегантно! Ще има още статии. Ако някой има интерес да прочете нещо подобно, нека се абонира, за да не пропуснете.

4. Дарения

Източник: www.habr.com