SendGrid Web API

難しいメール送信を手軽に

Transcript

1. SendGrid Web API ೉͍͠ϝʔϧૹ৴Λखܰʹ
2. ͓୊ » ϝʔϧۀ຿ » SMTP / Web API » ·ͱΊ
3. ϝʔϧ ϝʔϧͷૹ৴ྉ͸ ૿Ճ͠ଓ͚͍ͯΔɻ ʢ݄ؒ 270ԯ௨ʣ
4. ϝʔϧͷछྨ » Transactional Mail » ձһొ࿥ɺωοτ௨ൢɺύεϫʔυมߋ » Marketing Mail » Ӧۀɾސ٬ಈ޲ɾᅂ޷෼ੳ
5. ϝʔϧͷ࢓ࣄ͸େม » Πϯϑϥઃܭɾߏங » ੒௕ʹ߹Θͤͯεέʔϧ (ෆಈ࢈Խ) » อक » ιϑτ΢ΣΞΠϯετʔϧ » ؂ࢹج൫ » ηΩϡϦςΟ » ۓٸো֐ରԠ
6. ϝʔϧͷ࢓ࣄ͸େม » ϑΟʔυόοΫϧʔϓͷγεςϜԽ » ໎࿭ϝʔϧ / εύϜτϥοϓճආ » ղ໿৘ใͷऩू » Open / ClickτϥοΩϯά
7. ϝʔϧͷ࢓ࣄ͸େม » ISPͷBlocklist » ೝূ » SPF: ૹ৴ݩIPΞυϨεΛ֬ೝɻ » DKIM: ిࢠॺ໊Λ෇༩͠ૹ৴ݩ͕ਖ਼౰͔ݕূɻ » DMARC: SPF/ DKIM྆ํʹࣦഊͨ͠৔߹ͷϧʔϧɻ
9. ϝʔϧͷ࢓ࣄ͸େม » Ϛʔέολͷχʔζ » ϩάղੳج൫ » υϦϧμ΢ϯ༻γεςϜߏங
10. ϝʔϧͷ࢓ࣄ͸େม » ίετ͕അࣛʹͳΒͳ͍ » ސ٬ͱͷՍ͚ڮ ͱͯ΋େࣄ ͱͯ΋େม
11. SendGrid » Ϋϥ΢υϕʔεͷSMTPαʔϏε » ղܾ͢Δͷ͸… » ΤϯδχΞͷۤ೰ » Ϛʔέολͷۤ೰ » ड৴ऀͷۤ೰ » ͦͷ݁Ռ… Ϗδωεʹूத // ΑΓॏཁͳ࣮૷ʹूத
12. SMTPαʔϏεʁ » ಥ͖٧ΊΕ͹… ϝʔϧΛಧ͚Δ͜ͱʢૹΔ͡Όͳͯ͘ʣ » ϝʔϧΛಧ͚Δ… ਖ਼͘͠ɺૉૣ͘ɺͨ͘͞Μ » Ͳ͏΍ͬͯ… SMTP X-SMTPAPI
13. SMTP Transport $ telnet smtp.sendgrid.net 587 $ openssl s_client -connect smtp.sendgrid.net:465 » High Latency αʔόͱͷ΍ΓऔΓ͕ଟ͍
14. SMTP Transport 220 SG ESMTP service ready at ismtpd0017p1sin1.sendgrid.net 250-smtp.sendgrid.net 250-8BITMIME 250-PIPELINING 250-SIZE 31457280 250-STARTTLS 250-AUTH PLAIN LOGIN 250 AUTH=PLAIN LOGIN 334 VXNlcm5hbWU6 334 UGFzc3dvcmQ6 235 Authentication successful 250 Sender address accepted 250 Recipient address accepted 354 Continue 250 Ok: queued as sS0HQxlITZWHC4Q4BrLInw 221 See you later
15. Web Transport POST /api/mail.send.json HOST: api.sendgrid.com to=somebody@example.com&from=someone@example.com
16. X-SMTPAPI ֦ுϔομ: X-SMTPAPI: { ... } { "user": "************", "pass": "************", "tos": [ "sg000@sink.sendgrid.net", "sg001@sink.sendgrid.net", "sg002@sink.sendgrid.net", ... "sg999@sink.sendgrid.net" ] }
17. ଎౓ൺֱ X-SMTPAPIͰ΋ɺѼઌ͝ͱʹίωΫγϣϯΛ͸ΔΑΓ͸े෼ߴ଎Ͱ͢ ͕ɻ » 100௨ͷϝʔϧΛX-SMTPAPIͰૹ৴ » ϩʔΧϧͰͷૹ৴։͔࢝Βɺ100௨ͷૹ৴ॲཧ͕׬ྃ͢Δ·Ͱ
18. SMTP require 'mail' require 'smtpapi' # sendgrid/smtpapi-ruby smtapi = Smtpapi::Header.new ... mail = Mail.new(charste: UTF-8) do ... end mail['X-SMTPAPI'] = smtpapi.to_json mail.delivery_method(:smtp, address: 'smtp.sendgrid.net', port: 587, domain: 'gmail.com', authentication: :login, user_name: sendgrid_username, password: sendgrid_password) Ѽઌ100݅Ͱ7ඵ
19. Web API v2 curl -X POST https://api.sendgrid.com/api/mail.send.json \ -H "Authorization: Bearer ${SENDGRID_API_KEY}" \ -d to=to@example.com \ -d from=from@example.com \ -d subject="Hello Word" \ -d text="This is a test email. Delete me whenever you like." \ -d headers='{"X-SMTPAPI":"{\"to\":[\"test001@sink.sendgrid.net\",...]}"}' Ѽઌ100݅Ͱ4ඵ
20. ൺֱ » SMTP: 7ඵ (SMTP 1ίωΫγϣϯ/ SMTPAPI) » Web API v2: 4ඵ
21. ൺֱ » SMTPͷσϑΥϧτϙʔτ໰୊ » SMTP͸Φʔόʔϔου͕େ͖͍ » SMTPͷઃఆ͸໘౗͍͘͞ » Web API͸࣮૷͕؆୯ » ։ൃऀʹ΍͍͞͠ Web APIܦ༝ͰɺαΫοͱϝʔϧૹ৴͠·͠ΐ͏
22. Libraries » sendgrid/sendgrid-nodejs » sendgrid/sendgrid-php » sendgrid/sendgrid-python » sendgrid/sendgrid-go » sendgrid/sendgrid-ruby » sendgrid/sendgrid-csharp » sendgrid/sendgrid-cobol » sendgrid/sendgrid-perl
23. API » ϚʔέςΟϯά » Ѽઌ؅ཧ » ೝূઃఆ » ૹ৴ (΄΅)͢΂ͯͷػೳΛAPIܦ༝Ͱ
24. Web API v3 ग़·ͨ͠! ͞Βʹૉૣ࣮͘૷ curl -X POST https://api.sendgrid.com/v3/mail/send \ -H "Authorization: Bearer ${SENDGRID_API_KEY}" \ -H "Content-Type: application/json" \ -d @data.json ͪ͜Β΋ɺѼઌ100݅Ͱ4ඵ
25. data.json { "personalizations": [ { "to": [ { "email": "test001@sink.sendgrid.net" }, ... ], "subject": "Hello, World" } ], "from": { "email": "from@example.com" }, ...
26. ... "content": [ { "type": "text/plain", "value": "This is a test email. Delete me whenever you like." } ] } JSONͷόϦσʔτ ৄ͘͠͸ͪ͜Βɻ https://sendgrid.com/docs/APIReference/WebAPI_v3/Mail/ index.html
27. ศརػೳ » Event Webhook ൃੜͨ͠Πϕϯτ৘ใΛࢦఆͨ͠URLʹPOST ྫ) ϩάղੳج൫ » Inbound Parse Webhook ड৴ͨ͠ϝʔϧΛࢦఆͨ͠URLʹPOST ྫ) ࣗࣾΞϓϦέʔγϣϯͰϝʔϧΛड৴ ྫ) ϝʔϧΛτϦΨʔʹ
28. ͋Γ͕ͱ͏͍͟͝·ͨ͠ » υΩϡϝϯτ&νϡʔτϦΞϧ: https://sendgrid.kke.co.jp/docs/ » ެࣜϥΠϒϥϦ: https://github.com/sendgrid/ » KKE sample codes: https://github.com/sendgridjp/ Happy Sending!