Yandex 関数がメールを送信する

今日はいわゆるものを作成します。 ヤンデックス機能 (正式名称 Yandexクラウド機能）、郵送サービスと共謀した SendGrid は、安らかに眠っているユーザーに「石鹸」を送信します（冗談です。私たちは皆、スパムに反対していることを知っています）。

私はまた、従来のサーバーの反対者 (ただし熱狂的ではありません) であり、いわゆるサーバーの支持者でもあります。 サーバーレス (サーバーレス) ソリューション。私はサーバーの管理が好きではない (そしてその方法がよくわからない) ので、さらにサーバーが負荷がかかっていない時間に対して料金を支払う必要があるからです。 もう一つは機能です。 私がいなくても誰かがサービスを提供し、私は通話料のみを支払います。 2019 年 XNUMX 月初め、Yandex は Yandexクラウド機能 - ロシア連邦では初のようです サーバーレス。 そして特に素晴らしいのは、アリスのスキルは基本的に無料であるため、それ以来ずっと私の周辺視野にありました。 でも、もう始めましょう。

このシナリオを想像してみましょう。 あなたのアプリケーション (例: アリスのスキル) 覚えて忘れる ちなみに、これも機能します Yandexの機能) は、追加オプションなどのデジタル製品の購入をユーザーに促し、ユーザーは支払いを行います。 ある種の支払いシステム (紛らわしいことに似ています) Yandexの）支払いを処理し、指定したアドレスに送信します（電話をかけるためのリンクがあります） Yandexの機能) HTTP- 金額、氏名、電話番号、支払者の電子メールなど、支払いの詳細を含むリクエスト。 このデータを何らかの方法で処理したいと考えています。たとえば、金額を確認し、データベースに適切なエントリを作成し、ユーザーに送信します。 SMS и メール 支払いの受領確認とさらなる指示が記載されています。 だからあなた自身 マイクロサービス.

どのようにしてから Yandexの機能 データベースにエントリを作成する クラウドファイヤーストア チュートリアルですでに説明しました アリスは全てを覚えている (そして将来的には、別のデータベースの例を検討することになると思います - ヤンデックスデータベース）。 ユーザーへの送信方法について SMS 私たちのアプリケーションを次のものと統合します Yandex.Money —近いうちに解決するつもりです。 さて、手紙を送ることに取り掛かりましょう。

1.SendGridでアカウントを作成する

注意SendGrid は私の選択にすぎません。これにはいくつかの理由があります。主な理由は、Node.js 用の既製の SDK があることです。 他の郵送サービスを選択することもできます。

進みます アカウント登録ページへ そこにある登録フォームに記入します。 それでは、次へ行きます ダッシュボード、ナビゲーション パネルで選択します 電子メール API -> 統合ガイド、そしてメインパネル上で - Web API инажимаемкнопку 選択する。 すべては写真の通りです:

次のステップでは、 Node.js:

次に私たちが考え出すのは、 API-key name (コンソールのキーのリストにのみ表示され、今後のコードとは関係ありません。不朽の名前を思いついただけです) デモ API キー）を押してボタンを押します キーの作成:

キーが生成され、私たちはそれをコピーして極秘に保管します。 ボタンのある画面が表示されます 統合の検証、下の図のように、まだクリックしませんが、コードの記述に進みましょう。

2. コードを書く

しかし、ご覧のとおり、コード自体は驚くほど小さく、22 行です。

列をなして #8 私の電子メールはハードコーディングされています (したがって恥ずかしがって隠されています) - あなたの電子メールを示してください。 実際には、すべてのデータ (以下を含む) を受信します。 email) オブジェクトから イベント。 たとえば、メソッドの場合、 POST オブジェクトが関数に送信されます user フィールド（プロパティ）あり email、このフィールドの値は次のように取得できます。

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

そして、メールアドレスがメソッドを使用して関数に渡された場合、 GETたとえば、次のようになります。 https://functions.yandexcloud.net/123abc?[email protected]
パラメータ値 email 次のように取得できます:

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

ここではパッケージのみが必要です @sendgrid/メール。 ビニール袋 電子メールバリデーター 電子メール アドレスの有効性をチェックします (なぜすぐに推測できなかったのでしょうか?) が、それが確実な場合 (私たちがいないうちに長い間すでにチェックされている)、インストールする必要はありません (そして、もちろん、コード内でチェックする必要はありません)。 ビニール袋 ドテンフ ファイルからレコードを読み取るように設計されています .env ランタイム変数として。 しかし、 Yandexの機能 これらの変数をランタイム環境に直接配置することができます。 どうやって？ - 以下に示します。 したがって、パッケージは ドテンフ また、それをインストールすることもできません。 .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の機能 私の記事で説明した ビットリックスの国のアリス - 私は無知な人々をこの国に送り、その他の人々（そして帰国した人々）には小さな漫画本（つまり、一連の写真と文章）を送ります。

作成 ZIP-archive (たとえば、次のように呼びます) メーラー.zip)、そこにはディレクトリが含まれます node_modules とファイル .env、index.js - プロジェクト カタログのすべて:

という名前の関数を作成します...正しくは - メーラー、左側のナビゲーションメニューに次のように入力します エディタ、必須フィールドに入力し、タブに切り替えます ZIP アーカイブ アーカイブをダウンロード メーラー.zip:

そして、これが前述のダウンロードオプションです APIキー プロジェクト内にファイルを作成するのではなく、ここで直接 .env、パッケージをインストールしません ドテンフ。 ただし、これはすべてすでに行っているので、情報として示しています。 つまり、複製する必要はありません。

右上隅にあるボタンをクリックします バージョンの作成、数秒待ちます。 すべての準備が完了すると、自動的にセクションに移動します Обзор。 そこでオプションを有効にします 公共機能外部の世界からそれと対話できるようにします。

碑文の反対側に青いリンクが表示されます 通話リンク? クリックして。 空のブラウザ ウィンドウが開きます...しかし待ってください。次のようなメールを受け取りました。

これでコンソールに戻ることができます SendGridを選び、 ボタンを押す 統合の検証。 システムはそのチャネルを通じてすべてをチェックし、その結果、次のような画面が返されます。

それだけです、皆さん（もちろん女の子も）、すべてがとてもシンプルでエレガントです！ もっと記事が増えるでしょう。 このような記事を読みたい人がいたら、見逃さないように購読してください。

4. 寄付

出所： habr.com