อีเมลในแอปทำให้ง่ายขึ้นด้วย Appery.io และปลั๊กอิน SendGrid Mail API ใหม่
เผยแพร่แล้ว: 2015-06-09ต่อไปนี้เป็นโพสต์ของแขกจาก Max Katz ที่ Appery.io เรียนรู้เพิ่มเติมเกี่ยวกับ Max ที่ด้านล่างของโพสต์นี้
SendGrid เป็นหนึ่งในบริการที่ทำให้การเพิ่มความสามารถอีเมลในแอปเป็นเรื่องง่ายเกินไป SendGrid เป็นผู้ให้บริการโซลูชันอีเมลบนคลาวด์และให้ REST API ที่สวยงามและใช้งานง่ายเพื่อส่งอีเมลจากแอปมือถือ เป็นไปได้มากที่แอปของคุณต้องส่งอีเมล เช่น การยืนยันการลงทะเบียน อีเมลรีเซ็ตรหัสผ่าน อีเมลยืนยันสองขั้นตอน อีเมลแจ้งเตือนทั่วไป หรือการสื่อสารทางอีเมลประเภทอื่นๆ SendGrid เป็นโซลูชั่นที่สมบูรณ์แบบ
Appery.io แพลตฟอร์มมือถือและเว็บที่สมบูรณ์แบบที่สุดที่นำเสนอเป็นบริการ ช่วยให้องค์กรต่างๆ สร้างแอปที่ตอบสนองและรวดเร็วมาก Appery.io ผสมผสานสภาพแวดล้อมการพัฒนาอย่างรวดเร็วบนคลาวด์เข้ากับบริการแบ็คเอนด์แบบบูรณาการและแคตตาล็อกของปลั๊กอิน API ที่ทำให้การผสานรวมกับบริการคลาวด์และระบบองค์กรง่ายขึ้นอย่างมาก
การผสานการทำงานที่พร้อมใช้งานทันทีของ Appery.io กับ API ของบริษัทอื่น เหมาะอย่างยิ่งสำหรับการสร้างแอปบนอุปกรณ์เคลื่อนที่ที่รองรับการรับส่งข้อความอย่างรวดเร็วด้วย SendGrid API เพื่อให้เพิ่มความสามารถอีเมลในแอพได้เร็วยิ่งขึ้น Appery.io ได้เปิดตัวปลั๊กอิน SendGrid Mail API คุณสามารถเพิ่มปลั๊กอินลงในแอปใหม่หรือที่มีอยู่ได้อย่างรวดเร็ว และให้แอปตัวอย่างที่ส่งข้อความอีเมลพร้อมไฟล์แนบ นักพัฒนาสามารถปรับแต่งหรือแก้ไขปลั๊กอินได้ตามต้องการ
ในโพสต์นี้ ฉันจะแสดงวิธีเพิ่มและใช้ปลั๊กอิน SendGrid Mail API
สิ่งที่คุณต้องการ:
ก่อนที่คุณจะเริ่มต้น คุณจะต้องมีบัญชี SendGrid และ Appery.io ใช้ลิงก์ด้านล่างเพื่อลงทะเบียนบัญชีฟรี
- SendGrid
- Appery.io
คุณจะสร้างอะไร
คุณกำลังจะสร้างแอพมือถือใหม่ และเพิ่ม SendGrid Mail API เพื่อส่งอีเมล แอพตัวอย่างจากปลั๊กอินช่วยให้คุณ:
- ส่งอีเมลพร้อมไฟล์แนบ
- ถ่ายภาพและรวมภาพถ่ายเป็นไฟล์แนบ
นี่คือลักษณะของแอปเมื่อทำงานบนอุปกรณ์ Android:
คุณยังสามารถดูวิดีโอเกี่ยวกับวิธีใช้ปลั๊กอิน SendGrid:
การสร้างแอพมือถือใหม่:
ขั้นตอนแรกคือการสร้างแอพใหม่ใน Appery.io:
- เมื่อคุณอยู่ในแพลตฟอร์มแล้ว ให้คลิกปุ่ม สร้างแอปใหม่ สำหรับชื่อแอป ให้ป้อน SendGridApp (เลือกตัวเลือก PhoneApp เริ่มต้น) แล้วคลิกปุ่ม สร้าง
- จากมุมมอง โปรเจ็ กต์ ให้คลิกที่ Pages > startScreen หน้าจออุปกรณ์จะเปิดขึ้น หน้าควรมีลักษณะดังนี้:
คุณเพิ่งสร้างแอพมือถือใหม่เอี่ยม นั่นเป็นเรื่องง่ายใช่มั้ย?
การเพิ่มปลั๊กอิน SendGrid:
เมื่อคุณมีแอปใหม่แล้ว คุณจะเพิ่มปลั๊กอิน SendGrid
1. ในการนำเข้าปลั๊กอิน ให้คลิก สร้างใหม่ > จากปลั๊กอิน :
2. ในหมวด การสื่อสาร คุณจะเห็น SendGrid Mail API :
3. คลิก นำเข้าปลั๊กอินที่เลือก
4. ระบบจะถามว่าต้องการตั้งค่าหน้าเริ่มต้นหรือไม่ ไปข้างหน้าและเลือกหน้า จดหมาย คุณเปลี่ยนหน้าเริ่มต้นเสมอโดยไปที่ Project > App settings > General
5. ขั้นตอนนี้เป็นทางเลือก แต่คุณสามารถเปลี่ยนธีมที่ใช้ในแอปนี้ได้
ก. ไปที่ โปรเจ็กต์ > การตั้งค่าแอพ > ทั่วไป
ข. สำหรับ Theme ให้เลือก Material-design
6. เปิด หน้า > หน้าจดหมาย หน้าจะมีลักษณะดังนี้ (โดยใช้ธีมการออกแบบวัสดุ):
ปลั๊กอินประกอบด้วยแอปตัวอย่าง ในการทดสอบแอป คุณต้องกำหนดค่าปลั๊กอิน SendGrid API คุณกำลังจะทำสิ่งนี้ต่อไป แต่ก่อนอื่น คุณต้องตรวจสอบให้แน่ใจว่าข้อมูลบัญชี SendGrid ของคุณได้รับการปกป้อง
การตั้งค่าพร็อกซีที่ปลอดภัย:
เมื่อคุณลงชื่อสมัครใช้บัญชี SendGrid คุณจะได้รับชื่อผู้ใช้และคีย์ API (รหัสผ่านของคุณ) เพื่อใช้เมื่อเรียกใช้ API คุณต้องการเก็บข้อมูลที่ละเอียดอ่อนนี้ไว้บนเซิร์ฟเวอร์ เพราะถ้ามีคนเข้าถึงข้อมูลนี้ พวกเขาจะส่งอีเมลโดยใช้บัญชีของคุณได้ พร็อกซีที่ปลอดภัยจะปกป้องข้อมูลนี้ จึงไม่ปรากฏในไคลเอ็นต์
ขั้นตอนแรกในการสร้างพร็อกซีที่ปลอดภัยคือการสร้างฐานข้อมูลที่จะจัดเก็บชื่อผู้ใช้และรหัสผ่าน
1. จากตัวสร้างแอป คลิก ฐานข้อมูล (ในแถบเครื่องมือ) หรือไปที่ http://appery.io/database
2. คลิก สร้างฐานข้อมูลใหม่ สำหรับชื่อฐานข้อมูล ให้ป้อน: SendGridDB คลิก สร้าง
3. ตอนนี้ คุณต้องสร้างคอลเลกชันใหม่ คลิก สร้างคอลเลกชันใหม่ ตั้งชื่อคอลเลกชัน Credentials
4. คลิก +Col เพื่อสร้างคอลัมน์ใหม่ ตั้งชื่อคอลัมน์: คีย์
5. สร้างคอลัมน์อื่นแล้วตั้งชื่อว่า: keyValue
6. ตอนนี้คุณกำลังจะป้อนคีย์ SendGrid ลงในฐานข้อมูล
ก. คลิก +แถว แล้วป้อน api_user_proxy และค่าของมัน (นั่นคือชื่อผู้ใช้ของคุณ)
ข. ทำซ้ำเช่นเดียวกันสำหรับ api_key คลิก +แถว แล้วป้อน api_key_proxy และค่าของมัน (นั่นคือรหัสผ่านของคุณ) คอลเล็กชันของคุณควรมีลักษณะดังนี้:
ด้วยข้อมูลที่บันทึกไว้ในฐานข้อมูล ขณะนี้มีความปลอดภัยและเป็นส่วนตัว ถัดไป คุณจะต้องสร้างพร็อกซีที่ปลอดภัยซึ่งจะใช้ข้อมูลที่คุณเพิ่งบันทึกไว้ในฐานข้อมูล:
1. คลิกที่แท็บ Secure Proxy หรือไปที่ http://appery.io/proxy
2. คลิก สร้างพร็อกซีใหม่ ตั้งชื่อพร็อกซี SendGridProxy คลิก สร้าง
3. ในหน้าการตั้งค่าพร็อกซี ให้เลือก ใช้พร็อกซี + เก็บข้อมูลสำคัญ (ส่วนตัว) ในฐานข้อมูล
4. สำหรับฐานข้อมูล เลือก SendGridDB
5. สำหรับคอลเล็กชัน ให้เลือก ข้อมูลรับรอง
6. สำหรับคอลัมน์ Key เลือก key และสำหรับคอลัมน์ Value เลือก keyValue
7. คลิก บันทึก
ขั้นตอนสุดท้ายคือการกำหนดค่าบริการเพื่อใช้พร็อกซีนี้ ปลั๊กอินนี้มีบริการเดียวคือ SendGrid_Mail เพื่อส่งอีเมล ดังนั้นคุณต้องกำหนดค่าเพียงสองสามอย่าง:
- ภายในตัวสร้างแอป เปิด บริการ > บริการ SendGrid_Mail
- สำหรับ Use Appery.io proxy ให้คลิกปุ่มรีเฟรชเพื่อโหลดพร็อกซีใหม่ที่คุณเพิ่งสร้างขึ้นและเลือก (SendGridProxy)
- สลับไปที่แท็บ คำขอ แท็บนี้มีพารามิเตอร์คำขอบริการทั้งหมด คุณจะสังเกตเห็นว่าบริการจะได้รับ api_user และ api_key จากพร็อกซี พารามิเตอร์คำขอเดียวที่คุณต้องตั้งค่า มาจาก นี่คืออีเมล "จาก" ของคุณ
แท็บ คำขอ มีลักษณะดังนี้:
- api_key – คีย์ SendGrid API (รหัสผ่านของคุณ) บันทึกไว้ในฐานข้อมูล Appery.io เพื่อความปลอดภัย
- api_user – ชื่อผู้ใช้ SendGrid บันทึกไว้ในฐานข้อมูล Appery.io เพื่อความปลอดภัย
- ถึง – เพื่อส่งอีเมล
- toname (ตัวเลือก) – เพื่อชื่อ
- จาก – จากอีเมล
- fromname (ตัวเลือก) – จากชื่อ
- หัวเรื่อง – หัวเรื่องอีเมล
- ข้อความ – ข้อความอีเมล
คุณสามารถแก้ไขบริการและเพิ่มพารามิเตอร์คำขอเพิ่มเติมที่ SendGrid Mail API รองรับ
นอกจาก จาก (และ toname ที่ เป็นทางเลือกและ ชื่อจากต้นทาง) คุณไม่จำเป็นต้องตั้งค่าในบริการเนื่องจากจะถูกแมปจากหน้า นี่คือลักษณะของการแมปบนเพจ ( Pages > mail > Data > sendgrid_email service > Before send mapping ):
หากคุณต้องการเรียนรู้เพิ่มเติมเกี่ยวกับปลั๊กอิน แก้ไขแอพตัวอย่าง หรือส่งอีเมลโดยไม่มีไฟล์แนบ โปรดอ่านเอกสารประกอบของปลั๊กอิน
ทดสอบแอพ:
คุณพร้อมที่จะทดสอบแอปแล้ว
1. คลิกปุ่ม "ทดสอบ" เพื่อเปิดแอปในเบราว์เซอร์
ก. หากคุณทดสอบแอปในเบราว์เซอร์ คุณจะไม่สามารถเรียกใช้กล้องได้ คุณยังสามารถส่งข้อความ ภาพตัวอย่างที่สร้างใน Project > JavaScript > SampleImageScript จะถูกส่งไปแทน
2. ในการใช้กล้อง วิธีที่เร็วที่สุดคือใช้แอป Appery.io Tester หรือติดตั้งแอปบนอุปกรณ์
นี่คือการทดสอบแอปบนอุปกรณ์ Android:
การทดสอบแอปในเบราว์เซอร์ (คุณสามารถสแกนรหัส QR เพื่อเปิดแอปบนอุปกรณ์ของคุณในเบราว์เซอร์):
อะไรต่อไป?
หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับปลั๊กอิน โปรดไปที่หน้าเอกสารประกอบปลั๊กอิน คุณยังสามารถเพิ่ม SendGrid API อื่นๆ ในแอปของคุณได้อีกด้วย
นอกจาก Appery.io App Builder แล้ว คุณยังได้รับบริการแบ็กเอนด์แบบบูรณาการ เช่น ฐานข้อมูลบนคลาวด์ การแจ้งเตือนแบบพุช และสคริปต์เซิร์ฟเวอร์เพื่อเขียนตรรกะทางธุรกิจที่กำหนดเองสำหรับแอป
สรุป
การสร้างแอพที่มีความสามารถอีเมลในแอพด้วย SendGrid และ Appery.io นั้นรวดเร็วและง่ายดาย ปลั๊กอิน SendGrid API สามารถผสานรวม ทดสอบ และปลอดภัยได้อย่างรวดเร็วเมื่อสร้างแอปบนอุปกรณ์เคลื่อนที่ใน Appery.io
เกี่ยวกับผู้แต่ง : Max Katz หัวหน้าฝ่ายนักพัฒนาสัมพันธ์ของ Appery.io ซึ่งเป็นแพลตฟอร์มแอพมือถือบนคลาวด์ เขาชอบลองใช้ REST API ใหม่และเจ๋งในแอปมือถือ Max เป็นผู้เขียนหนังสือสองเล่ม “Practical RichFaces” (Apress 2008, 2011), DZone MVB (Most Valuable Blogger) และเป็นวิทยากรประจำในการประชุมนักพัฒนา คุณสามารถค้นหาว่า Max กำลังทำอะไรบนบล็อกของเขา: http://maxkatz.org และ Twitter: @maxkatz