Kazi za Yandex kutuma barua

Сегодня мы создадим т.н. Kazi ya Yandex (jina rasmi Kazi za Wingu la Yandex), ambayo ilishirikiana na huduma ya utumaji barua SendGrid будет слать «мыло» мирно спящим пользователям (шутка — я знаю, что все мы против спама).

Mimi pia ni mpinzani (lakini bila ushabiki) wa seva za jadi, na mfuasi wa kinachojulikana. salama (бессерверных) решений, поскольку не люблю (да и толком не умею) администрировать сервера, а ещё больше — платить за то время, когда они не нагружены. Другое дело — функции. Их кто-то обслуживает без меня, а я плачу только за вызовы. В начале октября 2019 г. Яндекс представил свои Kazi za Wingu la Yandex - inaonekana kuwa ya kwanza katika Shirikisho la Urusi salama. И что особо приятно — для навыков Алисы они вообще бесплатны, поэтому с тех пор находятся в поле моего периферийного зрения. Но давайте уже приступим.

Hebu tuwazie kisa hiki. Maombi yako (kwa mfano, ustadi wa Alice Kumbuka na Kusahau который, кстати, также работает на Kazi za Yandex) предлагает пользователю купить цифровой товар, например, дополнительные опции, и пользователь делает оплату. Некая платежная система (схожая до степени смешения с Yandex.Money) huchakata malipo na kuyatuma kwa anwani uliyotoa (na tutakuwa na kiungo cha kupiga simu Kazi za Yandex) HTTP- ombi lililo na maelezo ya malipo, kama vile kiasi, jina kamili, nambari ya simu na barua pepe ya mlipaji. Tunataka kuchakata data hii kwa njia fulani, kwa mfano: angalia kiasi, weka maingizo yanayofaa kwenye hifadhidata, tuma kwa watumiaji. SMS и Barua pepe na uthibitisho wa kupokea malipo na maagizo zaidi. Hivyo wewe mwenyewe huduma ndogo.

Kuhusu jinsi kutoka Яндекс-функций делать записи в БД Hifadhi ya Moto ya Wingu tayari tumeiangalia kwenye somo Alice anakumbuka kila kitu (na katika siku zijazo, nadhani, tutazingatia mfano kwa hifadhidata nyingine - Hifadhidata ya Yandex). О том, как отправлять пользователям SMS и интегрировать наше приложение с Yandex.Money — разберём в недалёком будущем. Сейчас займёмся только отправкой писем.

1. Fungua akaunti katika SendGrid

KumbukaSendGrid ni chaguo langu tu, ambalo nilifanya kwa sababu kadhaa, moja kuu ni kwamba wana SDK iliyotengenezwa tayari kwa Node.js. Unaweza kuchagua huduma nyingine yoyote ya utumaji barua.

Perekodim yangu kwa ukurasa wa usajili wa akaunti na ujaze fomu ya usajili hapo. Kisha tunaenda Dashibodi, kwenye paneli ya kusogeza chagua API ya Barua pepe -> Mwongozo wa Ujumuishaji, na kwenye paneli kuu - API ya Wavuti na нажимаем кнопку Kuchagua. Всё как на картинке:

Katika hatua inayofuata tunachagua node.js:

Далее придумываем для своего API-jina la ufunguo (itaonyeshwa tu kwenye koni kwenye orodha ya funguo, na haina uhusiano wowote na nambari yetu ya siku zijazo; nimekuja na isiyoweza kuharibika. demo-api-key) na bonyeza kitufe Unda Ufunguo:

Ufunguo utatolewa, tutainakili na kuiweka kwa ujasiri wa kina. Na tutakuwa na skrini iliyo na kitufe Thibitisha Ujumuishaji, как на картинке ниже, но мы её пока нажимать не станем, а перейдём к написанию кода:

2. Nambari ya kuandika

Lakini nambari yenyewe, kama unavyoona, ni ndogo sana - mistari 22!

Katika mstari #8 Barua pepe yangu ina msimbo ngumu (na kwa hivyo imefichwa kwa aibu) - tafadhali onyesha yako. Katika maisha halisi, tutapokea data zote (pamoja na enamel) из объекта tukio. Kwa mfano, ikiwa njia POST kitu kinatumwa kwa kazi yetu user na shamba (mali) enamel, thamani ya uwanja huu inaweza kupatikana kama hii:

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

Na ikiwa barua pepe inapitishwa kwa kazi kwa kutumia njia GET, kwa mfano: https://functions.yandexcloud.net/123abc?[email protected]
thamani ya parameta enamel можно получить эдак:

const email = event.queryStringParameters.email;

Чтобы взглянуть на то, что именно содержится в объекте tukio, unaweza kuunda rahisi zaidi Kazi ya Yandex na uizungushe na maswali:

module.exports.handler = async function (event) {
  return {
   'statusCode': 200, 
   'body': JSON.stringify(event)
  };
};

Подробнее (но менее доходчиво) об этом говорится в официальной документации hapa.

Итак, создаём каталог проекта (например, mtumaji), nenda kwake, anzisha mradi, sasisha utegemezi:

mkdir mailer
cd mailer
npm init -y
npm i @sendgrid/mail email-validator dotenv

Hapa kifurushi pekee kinahitajika @sendgrid/barua. Mfuko wa plastiki email-validator huangalia barua pepe ili kubaini uhalali (sikudhania mara moja?), lakini ikiwa tuna uhakika nayo (tayari imeangaliwa kwa muda mrefu bila sisi), sio lazima kuisakinisha (na, ya kwa kweli, sio lazima tuiangalie kwenye nambari). Mfuko wa plastiki dotenv iliyoundwa kusoma rekodi kutoka kwa faili .a kama vigezo vya wakati wa kukimbia. Lakini katika Kazi za Yandex имеется возможность помещать эти переменные непосредственно в среду выполнение. Как? — я покажу это ниже. Поэтому пакет dotenv также можно не ставить, и файл .a — не создавать, и при этом код в файле index.js usibadilike. Lakini hapa tumeweka kifurushi hiki, kwa hiyo tunaunda faili index.js и .a:

touch index.js
touch .env

Katika faili index.js пишем 22 строки кода, показанного на скриншоте выше (только в строке #8 поменяйте почту), а в файле .a - (bila nukuu au alama za uakifishaji) taja jozi - jina/thamani muhimu API, который мы недавно получили в консоли SendGrid:
SENDGRID_API_KEY=your-very-secret-sendgrid-api-key

Na ikiwa unataka kazi kidogo, unganisha hazina na usakinishe vifurushi:

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

Katika faili index.js, katika mstari #8 поменяйте почту; в корневом каталоге создайте файл .a, и в нём укажите имя/значение ключа API, как показано чуть выше.

3. Weka

Zaidi au chini ya wazi na kwa undani kuhusu Yandex.Cloud и о том, как там размещать Kazi za Yandex рассказано в моей статье Alice katika Ardhi ya Bitrix — несведущих отсылаю в эту страну, а для всех остальных (и вернувшихся) — далее небольшой комикс (т.е. серия картинок и текста).

Ninaweka mipangilio zip-hifadhi (wacha tuiite, kwa mfano, mailer.zip), в который включаем каталог moduli za moduli и файлы .env, index.js - kila kitu kutoka kwa orodha yetu ya mradi:

Tunaunda kitendakazi na jina... kwa usahihi - mtumaji, в левом навигационном меню вбираем Mhariri, jaza sehemu zinazohitajika, na ubadilishe kwa kichupo Kumbukumbu ya ZIP pakua kumbukumbu yetu mailer.zip:

Na hapa kuna chaguo lililotajwa hapo awali la kupakua API-key moja kwa moja hapa, badala ya kuunda faili kwenye mradi .a, na usisakinishe kifurushi dotenv. Lakini tayari tumefanya haya yote, kwa hivyo ninaionyesha kwa habari tu. Hiyo ni, hakuna haja ya kurudia!

Теперь в правом верхнем углу нажимаем кнопку Unda toleo, и ждём пару секунд. Когда всё будет готово, мы автоматически перейдём в раздел Pitia. Там включим опцию Shughuli ya umma, чтобы с ней можно было взаимодействовать из внешнего мира.

Unaona kiunga cha bluu kinyume na maandishi Kiungo cha simu? Нажмите её. Откроется пустое окно браузера… Но подождите — мне пришло письмо:

Теперь можно вернуться в консоль SendGrid, и нажать кнопку Thibitisha Ujumuishaji. Mfumo utaangalia kila kitu kupitia chaneli zake, na kwa sababu hiyo inapaswa kurudisha skrini kama hii:

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

4. Michango

Chanzo: mapenzi.com