Poczta e-mail w aplikacji uproszczona dzięki Appery.io i nowej wtyczce SendGrid Mail API

Opublikowany: 2015-06-09

Poniżej znajduje się gościnny post Maxa Katza na Appery.io. Dowiedz się więcej o Maxie na dole tego posta.

SendGrid to jedna z tych usług, które sprawiają, że dodawanie funkcji poczty e-mail w aplikacji jest zbyt proste. SendGrid jest dostawcą rozwiązania e-mail opartego na chmurze i zapewnia elegancki i łatwy w użyciu interfejs API REST do wysyłania wiadomości e-mail z aplikacji mobilnej. Jest bardzo prawdopodobne, że Twoja aplikacja będzie musiała wysyłać e-maile, takie jak potwierdzenia rejestracji, e-maile dotyczące resetowania hasła, e-maile z weryfikacją dwuetapową, e-maile z ogólnymi powiadomieniami lub inny rodzaj komunikacji e-mail. SendGrid to idealne rozwiązanie.

Appery.io, najbardziej kompletna platforma mobilna i internetowa oferowana jako usługa, umożliwia przedsiębiorstwom bardzo szybkie tworzenie responsywnych i mobilnych aplikacji. Appery.io łączy oparte na chmurze środowisko szybkiego programowania ze zintegrowanymi usługami zaplecza i katalogiem wtyczek API, które znacznie upraszczają integrację z usługami w chmurze i systemami korporacyjnymi.

Gotowa integracja Appery.io z dowolnym interfejsem API innych firm jest idealnym rozwiązaniem do szybkiego tworzenia aplikacji mobilnych obsługujących wiadomości za pomocą interfejsu API SendGrid. Aby jeszcze szybciej dodać funkcję poczty e-mail do aplikacji, Appery.io uruchomił wtyczkę SendGrid Mail API. Wtyczkę można szybko dodać do nowej lub istniejącej aplikacji i zapewnia przykładową aplikację, która wysyła wiadomość e-mail z załącznikiem. Deweloper może w razie potrzeby dostosować lub zmodyfikować wtyczkę.

W tym poście pokażę, jak dodać i używać wtyczki SendGrid Mail API.

Co będziesz potrzebował:

Zanim zaczniesz, będziesz potrzebować kont SendGrid i Appery.io. Skorzystaj z poniższych linków, aby zarejestrować bezpłatne konta.

  • WyślijGrid
  • Appery.io

Co zamierzasz zbudować?

Zamierzasz utworzyć nową aplikację mobilną i dodać interfejs API SendGrid Mail do wysyłania e-maili. Przykładowa aplikacja z wtyczki umożliwia:

  • Wyślij e-mail z załącznikiem.
  • Zrób zdjęcie i dołącz je jako załącznik.

Tak wygląda aplikacja działająca na urządzeniu z Androidem:

Możesz również obejrzeć film o tym, jak korzystać z wtyczki SendGrid:

Tworzenie nowej aplikacji mobilnej:

Pierwszym krokiem jest stworzenie nowej aplikacji w Appery.io:

  1. Gdy znajdziesz się na platformie, kliknij przycisk Utwórz nową aplikację . Jako nazwę aplikacji wpisz: SendGridApp (wybrano domyślną opcję PhoneApp ) i kliknij przycisk Utwórz .
  2. W widoku projektu kliknij Strony > startScreen . Otworzy się ekran urządzenia. Strona powinna wyglądać tak:

Właśnie stworzyłeś nową aplikację mobilną. To było łatwe, prawda?

Dodanie wtyczki SendGrid:

Teraz, gdy masz nową aplikację, zamierzasz dodać wtyczkę SendGrid.

1. Aby zaimportować wtyczkę, kliknij Utwórz nową > Z wtyczki :

2. W kategorii Komunikacja zobaczysz SendGrid Mail API :

3. Kliknij Importuj wybrane wtyczki .

4. Zostaniesz zapytany, czy chcesz ustawić stronę startową. Śmiało i wybierz stronę poczty . Zawsze zmieniasz stronę początkową, przechodząc do projektu > Ustawienia aplikacji > Ogólne .

5. Ten krok jest opcjonalny, ale możesz również zmienić motyw używany w tej aplikacji.

a. Przejdź do Projekt > Ustawienia aplikacji > Ogólne

b. Jako Motyw wybierz materiał-projekt

6. Otwórz Strony > strona pocztowa . Strona będzie wyglądać tak (przy użyciu motywu material-design):

Wtyczka zawiera przykładową aplikację. Aby przetestować aplikację, musisz skonfigurować wtyczkę SendGrid API. Zamierzasz to zrobić dalej, ale najpierw musisz upewnić się, że informacje o koncie SendGrid są chronione.

Konfigurowanie bezpiecznego serwera proxy:

Po zarejestrowaniu konta SendGrid otrzymasz nazwę użytkownika i klucz API (twoje hasło), które będą używane podczas wywoływania API. Chcesz zachować te poufne informacje na serwerze, ponieważ jeśli ktoś uzyska dostęp do tych informacji, będzie mógł wysyłać e-maile za pomocą Twojego konta. Bezpieczny serwer proxy ochroni te informacje, aby nigdy nie były widoczne w kliencie.

Pierwszym krokiem do stworzenia bezpiecznego proxy jest stworzenie bazy danych, która będzie przechowywać nazwę użytkownika i hasło.

1. W Kreatorze aplikacji kliknij Baza danych (na pasku narzędzi) lub przejdź do http://appery.io/database.

2. Kliknij Utwórz nową bazę danych . Jako nazwę bazy danych wpisz: SendGridDB . Kliknij Utwórz .

3. Teraz musisz stworzyć nową kolekcję. Kliknij Utwórz nową kolekcję . Nazwij kolekcję Credentials .

4. Kliknij +Col , aby utworzyć nową kolumnę. Nazwij kolumnę: klucz.

5. Utwórz kolejną kolumnę i nazwij ją: keyValue .

6. Teraz masz zamiar wprowadzić klucze SendGrid do bazy danych.

a. Kliknij +Row i wpisz api_user_proxy i jego wartość (to jest Twoja nazwa użytkownika).

b. Powtórz to samo dla api_key. Kliknij +Row i wpisz api_key_proxy i jego wartość (to jest Twoje hasło). Twoja kolekcja powinna wyglądać tak:

Dane zapisane w bazie danych są teraz zabezpieczone i prywatne. Następnie utworzysz bezpieczny serwer proxy, który będzie wykorzystywał dane, które właśnie zapisałeś w bazie danych:

1. Kliknij zakładkę Secure Proxy lub przejdź do http://appery.io/proxy.

2. Kliknij Utwórz nowy serwer proxy , nazwij serwer proxy SendGridProxy . Kliknij Utwórz .

3. Na stronie ustawień proxy zaznacz Użyj proxy + przechowuj poufne (prywatne) dane w bazie danych .

4. Jako Baza danych wybierz SendGridDB .

5. W polu Kolekcja wybierz Poświadczenia .

6. W polu Klucz wybierz klucz , a w polu Wartość wybierz kluczWartość .

7. Kliknij Zapisz .

Ostatnim krokiem jest skonfigurowanie usługi do korzystania z tego serwera proxy. Wtyczka ma jedną usługę, SendGrid_Mail, do wysyłania wiadomości e-mail, więc jest tylko kilka rzeczy, które musisz skonfigurować:

  1. W Konstruktorze aplikacji otwórz Usługi > Usługa SendGrid_Mail .
  2. Aby użyć serwera proxy Appery.io , kliknij przycisk odświeżania, aby załadować nowy serwer proxy, który właśnie utworzyłeś, i wybierz go (SendGridProxy).
  3. Przejdź do zakładki Żądanie . Ta zakładka zawiera wszystkie parametry zgłoszenia serwisowego. Zauważysz również, że usługa będzie pobierać api_user i api_key z serwera proxy. Jedynym parametrem żądania, który musisz ustawić, jest from . To jest Twój e-mail „od”.

Karta Żądanie wygląda tak:

  • api_key – klucz API SendGrid (twoje hasło). Zapisane w bazie danych Appery.io dla bezpieczeństwa
  • api_user — nazwa użytkownika SendGrid. Zapisane w bazie danych Appery.io dla bezpieczeństwa
  • do – na e-mail
  • toname (opcjonalnie) – to name
  • od – z e-maila
  • fromname (opcjonalnie) – from name
  • temat – temat wiadomości e-mail
  • tekst – tekst e-maila

Możesz zmodyfikować usługę i dodać więcej parametrów żądania obsługiwanych przez interfejs API SendGrid Mail.

Poza tym from (oraz opcjonalnie toname i fromname) nie musisz ustawiać wartości w serwisie, ponieważ będą one mapowane ze strony. Tak wygląda mapowanie na stronie ( Strony > poczta > Dane > usługa sendgrid_email > Przed wysłaniem mapowania ):

Jeśli chcesz dowiedzieć się więcej o wtyczce, zmodyfikować przykładową aplikację lub wysłać wiadomość e-mail bez załącznika, zapoznaj się z dokumentacją wtyczki.

Testowanie aplikacji:

Jesteś gotowy do przetestowania aplikacji.

1. Kliknij przycisk „Test”, aby uruchomić aplikację w przeglądarce.

a. Jeśli testujesz aplikację w przeglądarce, nie możesz wywołać aparatu. Nadal możesz wysłać wiadomość; zamiast tego zostanie wysłany przykładowy obraz utworzony w Project > JavaScript > SampleImageScript .

2. Najszybszym sposobem korzystania z aparatu jest skorzystanie z aplikacji Appery.io Tester lub zainstalowanie aplikacji na urządzeniu.

To jest testowanie aplikacji na urządzeniu z Androidem:

Testowanie aplikacji w przeglądarce (możesz zeskanować kod QR, aby uruchomić aplikację na swoim urządzeniu w przeglądarce):

Co dalej?

Aby dowiedzieć się więcej o wtyczce, odwiedź stronę dokumentacji wtyczki. Możesz również dodać do swojej aplikacji dowolne inne interfejsy API SendGrid.

Oprócz Appery.io App Builder otrzymujesz również zintegrowane usługi zaplecza, takie jak baza danych w chmurze, powiadomienia push i skrypty serwera do pisania niestandardowej logiki biznesowej dla aplikacji.

Streszczenie

Tworzenie aplikacji z obsługą poczty e-mail w aplikacji za pomocą SendGrid i Appery.io jest szybkie i proste. Wtyczkę SendGrid API można szybko zintegrować, przetestować i zabezpieczyć podczas tworzenia aplikacji mobilnej w Appery.io.

O autorze : Max Katz kieruje Developer Relations dla Appery.io, opartej na chmurze platformy aplikacji mobilnych. Uwielbia wypróbowywać nowe i fajne interfejsy API REST w aplikacjach mobilnych. Max jest autorem dwóch książek „Practical RichFaces” (Apress 2008, 2011), DZone MVB (Most Valuable Blogger) i jest częstym prelegentem na konferencjach deweloperskich. Możesz dowiedzieć się, co robi Max na swoim blogu: http://maxkatz.org i na Twitterze: @maxkatz.