Функциите на Yandex испраќаат пошта

Денес ќе создадеме т.н. Функција Yandex (официјално име Функции на облакот Yandex), кој договарал со услугата за пошта SendGrid ќе испрати „сапун“ до мирно заспаните корисници (само се шегувам - знам дека сите сме против спам).

И јас сум противник (но без фанатизам) на традиционалните сервери, и поддржувач на т.н. без серверот (без сервер) решенија, бидејќи не ми се допаѓа (и навистина не знам како да) администрирам сервери, а уште повеќе, плаќам за времето кога тие не се вчитани. Друга работа се функциите. Некој ги сервисира без мене, а јас плаќам само повици. На почетокот на октомври 2019 година, Yandex го претстави својот Функции на облакот Yandex - се чини дека е прв во Руската Федерација без серверот. И она што е особено убаво е што за вештините на Алис тие се генерално слободни, па оттогаш се во мојата периферна визија. Но, ајде да започнеме веќе.

Ајде да го замислиме ова сценарио. Вашата апликација (на пример, вештината на Алис Запомни и Заборави на што, патем, и работи Функции на Yandex) го поканува корисникот да купи дигитален производ, на пример, дополнителни опции, а корисникот врши плаќање. Некој вид на платен систем (збунувачки сличен на Yandex.Money) ја обработува исплатата и ја испраќа на адресата што ја давате (и ние ќе имаме врска до повик Функции на Yandex) HTTP-Побавка што содржи детали за плаќање, како што се износот, целосното име, телефонскиот број и е -поштата на плаќачот. Ние сакаме да ги обработуваме овие податоци на некој начин, на пример: Проверете ја количината, да направите соодветни записи во базата на податоци, испратете им на корисниците СМС и Е-пошта со потврда за приемот на плаќање и понатамошни упатства. Значи себе си микросервис.

За тоа како од Функции на Yandex направете записи во базата на податоци Облак-огноотпорница веќе го разгледавме во упатството Алис се сеќава на сè (И во иднина, мислам, ќе разгледаме пример за друга база на податоци - База на податоци на Yandex). За тоа како да се испрати до корисниците СМС и да ја интегрираме нашата апликација со Yandex.Money - ќе го средиме во блиска иднина. Сега да се занимаваме само со испраќање писма.

1. Направете сметка во SendGrid

Имајте на умSendGrid е само мојот избор, кој го направив од неколку причини, а главната е што имаат готов SDK за Node.js. Можете да изберете која било друга услуга за пошта.

Ајде да продолжиме на страницата за регистрација на сметката и пополнете го формуларот за регистрација таму. Потоа одиме на Профил, во панелот за навигација изберете API за е-пошта -> Водич за интеграција, и на главниот панел - Веб-API и притиснете го копчето Избери. Се е како на сликата:

Во следниот чекор избираме Node.js:

Следно доаѓаме со за нашите API-име на клучот (ќе се прикажува само во конзолата во списокот со клучеви и нема никаква врска со нашиот иден код; само што дојдов до непропадлив демо-апи-клуч) и притиснете го копчето Креирај клуч:

Клучот ќе се генерира, ќе го копираме и ќе го чуваме во најдлабока доверба. И ќе имаме екран со копче Потврдете ја интеграцијата, како на сликата подолу, но сè уште нема да кликнеме, но да преминеме на пишување на кодот:

2. Пишување код

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

Во линија #8 Мојата е-пошта е хардкодирана (и затоа е срамежливо скриена) - ве молиме наведете ја вашата. Во реалниот живот, ќе ги добиеме сите податоци (вклучувајќи е-маил) од објектот настанот. На пример, ако методот ПОСТ објект се испраќа до нашата функција корисникот со поле (сопственост) е-маил, вредноста на ова поле може да се добие вака:

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. Пластична кеса е-пошта-валидатор ја проверува валидноста на адресата на е-пошта (како не погодив веднаш?), но ако сме сигурни во тоа (веќе е проверено долго време без нас), не мора да го инсталираме (и, се разбира, не мора да го проверуваме во кодот). Пластична кеса дотенв дизајниран да чита записи од датотека .Н.С како променливи за траење. Но во Функции на Yandex Можно е да се постават овие променливи директно во околината за траење. Како? - Ќе го покажам подолу. Затоа пакувањето дотенв исто така не можете да го инсталирате, а датотеката .Н.С - не креирајте, а во исто време кодот е во датотеката индекс.js не менувај. Но, овде го инсталиравме овој пакет, па создаваме датотеки индекс.js и .Н.С:

touch index.js
touch .env

Во датотека индекс.js напишете 22 линии код прикажани на сликата од екранот погоре (само во линијата #8 сменете ја вашата е-пошта), и во датотеката .Н.С - (без никакви понуди или интерпункција) Наведете го името/вредноста на клучот 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

Во датотека индекс.js, во линија #8 промена на е-пошта; креирајте датотека во root директориумот .Н.С, и во него наведете го името/вредноста на клучот API, како што е прикажано веднаш погоре.

3. Распоредете

Повеќе или помалку јасно и детално за Yandex.Cloud и како да го поставите таму Функции на Yandex опишано во мојата статија Алиса во земјата на Битрикс - Ги испраќам неуките во оваа земја, а за сите други (и оние што се вратија) - потоа мал стрип (т.е. серија слики и текст).

Ние создаваме zip-архива (ајде да го наречеме, на пример, mailer.zip), во кој го вклучуваме директориумот модули на јазол и датотеки .env, index.js - сè од нашиот проект каталог:

Правиме функција со името... правилно - поштарот, во левото мени за навигација влегуваме Уредувачот, пополнете ги потребните полиња и префрлете се на јазичето ZIP архива преземете ја нашата архива mailer.zip:

И еве ја претходно споменатата опција за преземање API клуч директно овде, наместо да создадете датотека во проектот .Н.С, и не го инсталирајте пакетот дотенв. Но, ние веќе го направивме сето ова, па го прикажувам само за информација. Тоа е, нема потреба да се дуплира!

Сега во горниот десен агол кликнете на копчето Креирај верзијаи почекајте неколку секунди. Кога сè е подготвено, автоматски ќе одиме во делот Преглед. Таму ќе ја овозможиме опцијата јавна функцијаза да можете да комуницирате со него од надворешниот свет.

Ја гледате сината врска спроти натписот Линк до повик? Кликнете на неа. Ќе се отвори празен прозорец на прелистувачот... Но чекајте - добив е-пошта:

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

Тоа е тоа, момци (и девојки, се разбира) - сè е навистина многу едноставно и елегантно! Ќе има повеќе статии. Ако некој е заинтересиран да прочита вакво нешто, претплатете се за да не пропуштите.

4. Донации

Извор: www.habr.com