Упрощенная электронная почта в приложении с помощью Appery.io и нового плагина SendGrid Mail API

Опубликовано: 2015-06-09

Ниже приводится гостевой пост Макса Каца на Appery.io. Узнайте больше о Максе в нижней части этого поста.

SendGrid — одна из тех служб, которые делают добавление возможности электронной почты в приложении слишком простым. SendGrid — это поставщик облачного решения для работы с электронной почтой, который предоставляет элегантный и простой в использовании REST API для отправки электронных писем из мобильного приложения. Весьма вероятно, что вашему приложению необходимо отправлять электронные письма, такие как подтверждения регистрации, электронные письма для сброса пароля, электронные письма с двухэтапной проверкой, электронные письма с общими уведомлениями или любой другой тип связи по электронной почте. SendGrid — идеальное решение.

Appery.io, наиболее полная мобильная и веб-платформа, предлагаемая в качестве услуги, позволяет предприятиям очень быстро создавать адаптивные и мобильные приложения. Appery.io сочетает в себе облачную среду быстрой разработки с интегрированными серверными службами и каталогом подключаемых модулей API, которые значительно упрощают интеграцию с облачными службами и корпоративными системами.

Готовая интеграция Appery.io с любым сторонним API идеально подходит для быстрого создания мобильных приложений с поддержкой обмена сообщениями с помощью API SendGrid. Чтобы еще быстрее добавить возможность электронной почты в приложение, Appery.io запустила плагин SendGrid Mail API. Плагин можно быстро добавить в новое или существующее приложение, и он предоставляет пример приложения, которое отправляет сообщение электронной почты с вложением. Разработчик может настроить или изменить плагин по мере необходимости.

В этом посте я покажу вам, как добавить и использовать плагин SendGrid Mail API.

Что вам понадобится:

Прежде чем начать, вам понадобятся учетные записи SendGrid и Appery.io. Воспользуйтесь ссылками ниже, чтобы зарегистрировать бесплатные аккаунты.

  • SendGrid
  • Appery.io

Что вы собираетесь строить?

Вы собираетесь создать новое мобильное приложение и добавить API SendGrid Mail для отправки электронных писем. Пример приложения из плагина позволяет:

  • Отправьте электронное письмо с вложением.
  • Сфотографируйте и вложите фото в качестве вложения.

Вот как приложение выглядит при работе на Android-устройстве:

Вы также можете посмотреть видео о том, как использовать плагин SendGrid:

Создание нового мобильного приложения:

Первый шаг — создать новое приложение в Appery.io:

  1. Как только вы окажетесь внутри платформы, нажмите кнопку « Создать новое приложение ». В качестве имени приложения введите: SendGridApp (выбран параметр PhoneApp по умолчанию) и нажмите кнопку « Создать ».
  2. В представлении Project нажмите Pages > startScreen . Откроется экран устройства. Страница должна выглядеть так:

Вы только что создали новое мобильное приложение. Это было легко, верно?

Добавление плагина SendGrid:

Теперь, когда у вас есть новое приложение, вы собираетесь добавить плагин SendGrid.

1. Чтобы импортировать плагин, нажмите « Создать новый » > « Из плагина »:

2. В категории « Связь » вы увидите SendGrid Mail API :

3. Нажмите Импортировать выбранные плагины .

4. Вас спросят, хотите ли вы установить начальную страницу. Идите вперед и выберите страницу почты . Стартовую страницу всегда можно изменить, выбрав « Проект» > « Настройки приложения » > « Общие ».

5. Этот шаг не является обязательным, но вы также можете изменить тему, используемую в этом приложении.

а. Перейдите в «Проект» > «Настройки приложения» > «Общие».

б. Для Theme выберите material-design

6. Откройте «Страницы» > «Почтовая страница» . Страница будет выглядеть так (с использованием темы оформления материалов):

Плагин содержит образец приложения. Чтобы протестировать приложение, вам необходимо настроить подключаемый модуль SendGrid API. Вы собираетесь сделать это дальше, но сначала вам нужно убедиться, что информация вашей учетной записи SendGrid защищена.

Настройка безопасного прокси:

Когда вы регистрируетесь в учетной записи SendGrid, вы получаете имя пользователя и ключ API (ваш пароль) для использования при вызове API. Вы хотите сохранить эту конфиденциальную информацию на сервере, потому что, если кто-то получит доступ к этой информации, он сможет отправлять электронные письма, используя вашу учетную запись. Безопасный прокси-сервер защитит эту информацию, поэтому она никогда не будет видна клиенту.

Первым шагом к созданию безопасного прокси-сервера является создание базы данных, в которой будут храниться имя пользователя и пароль.

1. В App Builder щелкните База данных (на панели инструментов) или перейдите по адресу http://appery.io/database.

2. Щелкните Создать новую базу данных . В качестве имени базы данных введите: SendGridDB . Щелкните Создать .

3. Теперь вам нужно создать новую коллекцию. Щелкните Создать новую коллекцию . Назовите коллекцию Credentials .

4. Щелкните +Col , чтобы создать новый столбец. Назовите столбец: ключ.

5. Создайте еще один столбец и назовите его: keyValue .

6. Теперь вы собираетесь ввести ключи SendGrid в базу данных.

а. Нажмите +Row и введите api_user_proxy и его значение (это ваше имя пользователя).

б. Повторите то же самое для api_key. Нажмите +Row и введите api_key_proxy и его значение (это ваш пароль). Ваша коллекция должна выглядеть так:

Данные, сохраненные в базе данных, теперь защищены и конфиденциальны. Далее вы создадите безопасный прокси-сервер, который будет использовать данные, которые вы только что сохранили в базе данных:

1. Перейдите на вкладку «Безопасный прокси » или перейдите по адресу http://appery.io/proxy.

2. Нажмите Создать новый прокси , назовите прокси SendGridProxy . Щелкните Создать .

3. На странице настроек прокси установите флажок Использовать прокси + хранить конфиденциальные (частные) данные в базе данных .

4. Для базы данных выберите SendGridDB .

5. В разделе Коллекция выберите Учетные данные .

6. Для столбца Key выберите ключ , а для столбца Value выберите keyValue .

7. Нажмите Сохранить .

Последний шаг — настроить службу для использования этого прокси. Плагин имеет одну службу SendGrid_Mail для отправки электронной почты, поэтому вам нужно настроить всего несколько вещей:

  1. В App Builder откройте Службы > Служба SendGrid_Mail .
  2. В разделе «Использовать прокси-сервер Appery.io » нажмите кнопку «Обновить», чтобы загрузить новый прокси-сервер, который вы только что создали, и выберите его (SendGridProxy).
  3. Перейдите на вкладку Запрос . На этой вкладке находятся все параметры запроса на обслуживание. Вы также заметите, что служба будет получать api_user и api_key от прокси. Один параметр запроса, который вам нужно установить, — from . Это ваша электронная почта «от».

Вкладка « Запрос » выглядит так:

  • api_key — ключ API SendGrid (ваш пароль). Сохранено в базе данных Appery.io для безопасности
  • api_user — имя пользователя SendGrid. Сохранено в базе данных Appery.io для безопасности
  • to - отправить по электронной почте
  • toname (необязательно) – назвать
  • из - из электронной почты
  • fromname (необязательно) — от имени
  • тема – тема письма
  • текст – текст электронной почты

Вы можете изменить службу и добавить дополнительные параметры запроса, поддерживаемые API почты SendGrid.

Помимо from (и необязательно toname и fromname) вам не нужно устанавливать значения в сервисе, так как они будут сопоставлены со страницы. Вот как сопоставление выглядит на странице ( Страницы > почта > Данные > сервис sendgrid_email > Перед отправкой сопоставления ):

Если вы хотите узнать больше о подключаемом модуле, изменить пример приложения или отправить электронное письмо без вложения, ознакомьтесь с документацией по подключаемому модулю.

Тестирование приложения:

Вы готовы протестировать приложение.

1. Нажмите кнопку «Тест», чтобы запустить приложение в браузере.

а. Если вы протестируете приложение в браузере, вы не сможете вызвать камеру. Вы по-прежнему можете отправить сообщение; вместо этого будет отправлен образец изображения, созданный в Project > JavaScript > SampleImageScript .

2. Самый быстрый способ использовать камеру — использовать приложение Appery.io Tester или установить приложение на устройство.

Это тестирование приложения на устройстве Android:

Тестирование приложения в браузере (вы можете отсканировать QR-код, чтобы запустить приложение на вашем устройстве в браузере):

Что дальше?

Чтобы узнать больше о плагине, посетите страницу документации плагина. Вы также можете добавить в свое приложение любые другие API SendGrid.

В дополнение к Appery.io App Builder вы также получаете интегрированные серверные службы, такие как облачная база данных, push-уведомления и серверные сценарии для написания пользовательской бизнес-логики для приложения.

Резюме

Создание приложений с электронной почтой в приложении с помощью SendGrid и Appery.io происходит быстро и просто. Плагин SendGrid API можно быстро интегрировать, протестировать и защитить при создании мобильного приложения в Appery.io.

Об авторе : Макс Кац возглавляет отдел по связям с разработчиками Appery.io, облачной платформы для мобильных приложений. Он любит пробовать новые и классные REST API в мобильных приложениях. Макс является автором двух книг «Practical RichFaces» (Apress 2008, 2011), DZone MVB (Most Valuable Blogger) и часто выступает на конференциях разработчиков. Вы можете узнать, чем занимается Макс, в его блоге: http://maxkatz.org и в Твиттере: @maxkatz.