E-mail în aplicație simplificat cu Appery.io și noul plugin API SendGrid Mail

Publicat: 2015-06-09

Următoarea este o postare de la Max Katz la Appery.io. Aflați mai multe despre Max în partea de jos a acestei postări.

SendGrid este unul dintre acele servicii care face ca adăugarea capacității de e-mail în aplicație să fie mult prea simplă. SendGrid este un furnizor de soluții de e-mail bazate pe cloud și oferă un API REST elegant și ușor de utilizat pentru a trimite e-mailuri dintr-o aplicație mobilă. Este foarte probabil ca aplicația dvs. să trimită e-mailuri, cum ar fi confirmări de înregistrare, e-mailuri de resetare a parolei, e-mailuri de verificare în doi pași, e-mailuri generale de notificare sau orice alt tip de comunicare prin e-mail. SendGrid este soluția perfectă.

Appery.io, cea mai completă platformă mobilă și web oferită ca serviciu, permite întreprinderilor să creeze aplicații mobile receptive și foarte rapid. Appery.io combină un mediu de dezvoltare rapidă bazat pe cloud cu servicii back-end integrate și un catalog de pluginuri API care simplifică dramatic integrarea cu serviciile cloud și sistemele de întreprindere.

Integrarea imediată a Appery.io cu orice API terță parte este potrivirea perfectă pentru construirea rapidă a aplicațiilor mobile activate pentru mesagerie cu API-ul SendGrid. Pentru a adăuga capacitatea de e-mail la o aplicație și mai rapidă, Appery.io a lansat un plugin API SendGrid Mail. Pluginul poate fi adăugat rapid la o aplicație nouă sau existentă și oferă un exemplu de aplicație care trimite un mesaj de e-mail cu un atașament. Dezvoltatorul poate personaliza sau modifica pluginul după cum este necesar.

În această postare, vă voi arăta cum să adăugați și să utilizați pluginul API SendGrid Mail.

Ce vei avea nevoie:

Înainte de a începe, veți avea nevoie de conturi SendGrid și Appery.io. Utilizați linkurile de mai jos pentru a vă înregistra pentru conturi gratuite.

  • SendGrid
  • Appery.io

Ce ai de gând să construiești?

Veți crea o nouă aplicație mobilă și veți adăuga API-ul SendGrid Mail pentru a trimite e-mailuri. Exemplul de aplicație din plugin vă permite să:

  • Trimiteți un e-mail cu un atașament.
  • Faceți o fotografie și includeți fotografia ca atașament.

Iată cum arată aplicația când rulează pe un dispozitiv Android:

De asemenea, puteți vedea videoclipul despre cum să utilizați pluginul SendGrid:

Crearea unei noi aplicații pentru mobil:

Primul pas este să creați o nouă aplicație în Appery.io:

  1. Odată ce vă aflați în platformă, faceți clic pe butonul Creați o nouă aplicație . Pentru numele aplicației, introduceți: SendGridApp (opțiunea implicită PhoneApp selectată) și faceți clic pe butonul Creare .
  2. Din vizualizarea Proiect , faceți clic pe Pagini > startScreen . Se va deschide ecranul dispozitivului. Pagina ar trebui să arate astfel:

Tocmai ați creat o nouă aplicație mobilă. A fost ușor, nu?

Adăugarea pluginului SendGrid:

Acum că aveți o nouă aplicație, veți adăuga pluginul SendGrid.

1. Pentru a importa pluginul, faceți clic pe Create New > From Plug-in :

2. În categoria Comunicare , veți vedea API-ul SendGrid Mail :

3. Faceți clic pe Importați pluginuri selectate .

4. Veți fi întrebat dacă doriți să setați pagina de pornire. Continuați și selectați pagina de e- mail . Întotdeauna schimbați pagina de pornire accesând Proiect > Setări aplicație > General .

5. Acest pas este opțional, dar puteți schimba și tema folosită în această aplicație.

A. Accesați Proiect > Setări aplicație > General

b. Pentru Tema , selectați design-material

6. Deschideți Pagini > pagina de e-mail . Pagina va arăta astfel (folosind tema material-design):

Pluginul conține un exemplu de aplicație. Pentru a testa aplicația, trebuie să configurați pluginul API SendGrid. Veți face acest lucru în continuare, dar mai întâi trebuie să vă asigurați că informațiile contului dvs. SendGrid sunt protejate.

Configurarea unui proxy securizat:

Când vă înscrieți pentru un cont SendGrid, primiți un nume de utilizator și o cheie API (parola dvs.) pe care să le utilizați la invocarea API-ului. Doriți să păstrați aceste informații sensibile pe server, deoarece dacă cineva obține acces la aceste informații, va putea trimite e-mailuri folosind contul dvs. Proxy-ul securizat va proteja aceste informații, astfel încât să nu fie niciodată vizibile în client.

Primul pas pentru a crea un proxy securizat este crearea unei baze de date care va stoca numele de utilizator și parola.

1. Din App Builder, faceți clic pe Baza de date (în bara de instrumente) sau accesați http://appery.io/database.

2. Faceți clic pe Creare bază de date nouă . Pentru numele bazei de date, introduceți: SendGridDB . Faceți clic pe Creare .

3. Acum trebuie să creați o nouă colecție. Faceți clic pe Creare colecție nouă . Denumiți colecția Acreditări .

4. Faceți clic pe +Col pentru a crea o nouă coloană. Denumiți coloana: cheie.

5. Creați o altă coloană și denumiți-o: keyValue .

6. Acum veți introduce cheile SendGrid în baza de date.

A. Faceți clic pe +Rând și introduceți api_user_proxy și valoarea acestuia (acesta este numele dvs. de utilizator).

b. Repetați același lucru pentru api_key. Faceți clic pe +Rând și introduceți api_key_proxy și valoarea acesteia (aceasta este parola dvs.). Colecția ta ar trebui să arate astfel:

Cu datele salvate în baza de date, acestea sunt acum securizate și private. În continuare, veți crea proxy-ul securizat care va folosi datele pe care tocmai le-ați salvat în baza de date:

1. Faceți clic pe fila Secure Proxy sau accesați http://appery.io/proxy.

2. Faceți clic pe Creare proxy nou , denumiți proxy- ul SendGridProxy . Faceți clic pe Creare .

3. În pagina de setări proxy, bifați Utilizați proxy + stocați date sensibile (private) în baza de date .

4. Pentru Baza de date, selectați SendGridDB .

5. Pentru Colectare, selectați Acreditări .

6. Pentru coloana Cheie , selectați cheie și pentru coloana Valoare , selectați Valoare cheie .

7. Faceți clic pe Salvare .

Ultimul pas este configurarea serviciului pentru a utiliza acest proxy. Pluginul are un singur serviciu, SendGrid_Mail, pentru a trimite e-mailuri, așa că trebuie să configurați doar câteva lucruri:

  1. În App Builder, deschideți Servicii > serviciul SendGrid_Mail .
  2. Pentru Utilizați proxy Appery.io , faceți clic pe butonul de reîmprospătare pentru a încărca noul proxy pe care tocmai l-ați creat și selectați-l (SendGridProxy).
  3. Comutați la fila Solicitare . Această filă conține toți parametrii de solicitare a serviciului. Veți observa, de asemenea, că serviciul va primi api_user și api_key de la proxy. Singurul parametru de cerere pe care trebuie să-l setați este de la . Acesta este e-mailul tău „de la”.

Fila Solicitare arată astfel:

  • api_key – cheia API SendGrid (parola dvs.). Salvat în baza de date Appery.io pentru securitate
  • api_user – nume de utilizator SendGrid. Salvat în baza de date Appery.io pentru securitate
  • către – către e-mail
  • toname (opțional) – a nume
  • de la – din e-mail
  • fromname (opțional) – de la nume
  • subiect – subiectul e-mailului
  • text – text de e-mail

Puteți modifica serviciul și adăuga mai mulți parametri de solicitare acceptați de API-ul SendGrid Mail.

Pe lângă from (și opțional toname și fromname) nu trebuie să setați valorile în serviciu, deoarece acestea vor fi mapate din pagină. Iată cum arată maparea pe pagină ( Pagini > mail > Date > serviciu sendgrid_email > Înainte de a trimite maparea ):

Dacă doriți să aflați mai multe despre plugin, să modificați exemplul de aplicație sau să trimiteți un e-mail fără un atașament, vă rugăm să citiți documentația pluginului.

Testarea aplicației:

Sunteți gata să testați aplicația.

1. Faceți clic pe butonul „Test” pentru a lansa aplicația în browser.

A. Dacă testați aplicația în browser, nu puteți invoca camera. În continuare puteți trimite un mesaj; În schimb, va fi trimisă o imagine eșantion creată în Proiect > JavaScript > SampleImageScript .

2. Pentru a utiliza camera, cea mai rapidă modalitate este să utilizați aplicația Appery.io Tester sau să instalați aplicația pe un dispozitiv.

Aceasta este testarea aplicației pe un dispozitiv Android:

Testarea aplicației în browser (puteți scana codul QR pentru a lansa aplicația pe dispozitiv în browser):

Ce urmeaza?

Pentru a afla mai multe despre plugin, vă rugăm să vizitați pagina de documentație a pluginului. De asemenea, puteți adăuga orice alte API SendGrid în aplicația dvs.

Pe lângă Appery.io App Builder, obțineți și servicii backend integrate, cum ar fi o bază de date în cloud, notificări push și scripturi de server pentru a scrie logica de afaceri personalizată pentru aplicație.

rezumat

Crearea de aplicații cu capacitate de e-mail în aplicație cu SendGrid și Appery.io este rapidă și simplă. Pluginul SendGrid API poate fi integrat, testat și securizat rapid atunci când construiți o aplicație mobilă în Appery.io.

Despre autor : Max Katz conduce Relațiile cu dezvoltatorii pentru Appery.io, o platformă de aplicații mobile bazată pe cloud. Îi place să încerce noi și cool API-uri REST în aplicațiile mobile. Max este autorul a două cărți „Practical RichFaces” (Apress 2008, 2011), DZone MVB (Most Valuable Blogger) și este un vorbitor frecvent la conferințele dezvoltatorilor. Puteți afla ce face Max pe blogul său: http://maxkatz.org și Twitter: @maxkatz.