មុខងារ Yandex ផ្ញើសំបុត្រ

មុខងារ Yandex ផ្ញើសំបុត្រ

Сегодня мы создадим т.н. មុខងារ Yandex (официальное название មុខងារពពក Yandex), которая вступив в сговор с сервисом почтовых рассылок SendGrid будет слать «мыло» мирно спящим пользователям (шутка — я знаю, что все мы против спама).

А ещё я противник (но без фанатизма) традиционных серверов, и сторонник т.н. គ្មាន server (бессерверных) решений, поскольку не люблю (да и толком не умею) администрировать сервера, а ещё больше — платить за то время, когда они не нагружены. Другое дело — функции. Их кто-то обслуживает без меня, а я плачу только за вызовы. В начале октября 2019 г. Яндекс представил свои មុខងារពពក Yandex — кажется первый в РФ គ្មាន server. И что особо приятно — для навыков Алисы они вообще бесплатны, поэтому с тех пор находятся в поле моего периферийного зрения. Но давайте уже приступим.

Представим такой сценарий. Ваше приложение (например, навык Алисы Запомни и Забудь который, кстати, также работает на Яндекс-функциях) предлагает пользователю купить цифровой товар, например, дополнительные опции, и пользователь делает оплату. Некая платежная система (схожая до степени смешения с Yandex.Money) обрабатывает платеж, и шлёт на предоставленный вами адрес (а у нас это будет ссылка для вызова មុខងារ Yandex) របស់ HTTP-запрос, содержащий детали платежа, такие как сумма, ФИО, телефон и электронная почта плательщика. Мы же хотим эти данные каким-то образом обрабатывать, например: проверять сумму, делать соответствующие записи в базу данных, отправлять пользователям SMS и អ៊ីមែល с подтверждением получения оплаты и дальнейшими инструкциями. Такой себе សេវាមីក្រូ.

О том, как из Яндекс-функций делать записи в БД ហាងលក់ពពក мы уже рассматривали в туториале Алиса помнит всё (и в дальнейшем, думаю, рассмотрим пример для другой БД — Yandex Database). О том, как отправлять пользователям SMS и интегрировать наше приложение с Яндекс.Деньгами — разберём в недалёком будущем. Сейчас займёмся только отправкой писем.

1. Создание аккаунта в SendGrid

ការកត់សម្គាល់SendGrid — это лишь мой выбор, который я сделал по некоторым причинам, и главная из которых — наличие у них готового SDK для Node.js. Вы можете выбрать любой другой сервис почтовых рассылок.

Perekhodim របស់ខ្ញុំ на страницу регистрации аккаунта и заполняем там регистрационную форму. Затем переходим в Dashboard, в навигационной панели выбираем Email API -> Integration Guide, а на главной панели — គេហទំព័រ API жимажимаемкнопку ជ្រើស. Всё как на картинке:

មុខងារ Yandex ផ្ញើសំបុត្រ

На следующем шаге выбираем Node.js:

មុខងារ Yandex ផ្ញើសំបុត្រ

Далее придумываем для своего ការ API-ключа название (будет отображаться только в консоли в списке ключей, и к нашему будущему коду отношения не имеет; я вот придумал нетленное demo-api-key) ហើយចុចប៊ូតុង បង្កើតសោ:

មុខងារ Yandex ផ្ញើសំបុត្រ

Ключик сгенерируется, мы его скопируем и сохраним в глубочайшей тайне. А у нас появится экран с кнопкой Verify Integration, как на картинке ниже, но мы её пока нажимать не станем, а перейдём к написанию кода:

មុខងារ Yandex ផ្ញើសំបុត្រ

2. Написание кода

А самого кода, как видите, до смешного мало — 22 строки!

មុខងារ Yandex ផ្ញើសំបុត្រ

នៅក្នុងជួរ #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. ថង់ផ្លាស្ទិច email-validator проверяет на валидность адрес почты (как я сразу не догадался?), но если мы в нём уверены (давно уже проверено без нас), его можно не устанавливать (и в коде, естественно, проверку не делать). Пакет dotenv предназначен для чтения записей из файла .NS как переменных среды выполнения. Но в Яндекс-функциях имеется возможность помещать эти переменные непосредственно в среду выполнение. Как? — я покажу это ниже. Поэтому пакет dotenv также можно не ставить, и файл .NS — не создавать, и при этом код в файле index.js ។ не менять. Но здесь мы этот пакет установили, поэтому создаём файлы index.js ។ и .NS:

touch index.js
touch .env

នៅក្នុងឯកសារ index.js ។ пишем 22 строки кода, показанного на скриншоте выше (только в строке #8 поменяйте почту), а в файле .NS — (без каких-либо кавычек и знаков препинания) укажите пару — имя/значение ключа ការ API, который мы недавно получили в консоли SendGrid:
SENDGRID_API_KEY=your-very-secret-sendgrid-api-key

А если хотите, чтобы работы было поменьше — склонируйте репозиторий, установите пакеты:

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

នៅក្នុងឯកសារ index.js ។, в строке #8 поменяйте почту; в корневом каталоге создайте файл .NS, и в нём укажите имя/значение ключа ការ API, как показано чуть выше.

3. Деплой

Более-менее внятно и подробно о Yandex.Cloud и о том, как там размещать មុខងារ Yandex рассказано в моей статье អាលីសនៅក្នុងទឹកដីនៃប៊ីទ្រីក — несведущих отсылаю в эту страну, а для всех остальных (и вернувшихся) — далее небольшой комикс (т.е. серия картинок и текста).

Создаём បង្ហាប់-архив (назовём его, например, mailer.zip), в который включаем каталог ម៉ូឌុលថ្នាំង и файлы .env, index.js — все из каталога нашего проекта:

មុខងារ Yandex ផ្ញើសំបុត្រ

Создаём функцию с названием… правильно — អ្នកផ្ញើសំបុត្រ, в левом навигационном меню вбираем កម្មវិធីនិពន្ធ, заполняем необходимые поля, и переключившись на вкладку បណ្ណសារហ្ស៊ីប загружаем наш архив mailer.zip:

មុខងារ Yandex ផ្ញើសំបុត្រ

А вот и упомянутая ранее возможность загрузить API-key непосредственно здесь, а не создавать в проекте файл .NS, и не устанавливать пакет dotenv. Но мы всё это уже сделали, поэтому показываю просто для информации. То есть — дублировать не надо!

មុខងារ Yandex ផ្ញើសំបុត្រ

Теперь в правом верхнем углу нажимаем кнопку បង្កើតកំណែ, и ждём пару секунд. Когда всё будет готово, мы автоматически перейдём в раздел ទិដ្ឋភាពទូទៅ. Там включим опцию មុខងារសាធារណៈ, чтобы с ней можно было взаимодействовать из внешнего мира.

មុខងារ Yandex ផ្ញើសំបុត្រ

Видите синюю ссылку напротив надписи តំណហៅទូរសព្ទ? Нажмите её. Откроется пустое окно браузера… Но подождите — мне пришло письмо:

មុខងារ Yandex ផ្ញើសំបុត្រ

Теперь можно вернуться в консоль SendGrid, и нажать кнопку Verify Integration. Система проверит всё по своим каналам, и в результате должна вернуть такой вот экран:

មុខងារ Yandex ផ្ញើសំបុត្រ

Вот так, ребята (и девчата, разумеется) — всё действительно очень просто и элегантно! Будут ещё статьи. Кому читать подобное интересно — подписывайтесь, чтобы не пропустить.

4. Донаты

មុខងារ Yandex ផ្ញើសំបុត្រ

ប្រភព: www.habr.com

បន្ថែមមតិយោបល់