Trong phần bắt đầu nhanh này, bạn sẽ tìm hiểu cách gửi email đầu tiên của mình bằng cách sử dụng API gửi thư Twilio SendGrid và Python
điều kiện tiên quyết
Đảm bảo thực hiện các điều kiện tiên quyết sau để hoàn thành hướng dẫn này. Bạn có thể bỏ qua nếu bạn đã hoàn thành các tác vụ này
- Đăng ký tài khoản SendGrid
- Bật xác thực hai yếu tố
- Tạo và lưu trữ Khóa API SendGrid bằng Gửi thư > Quyền truy cập đầy đủ
- Hoàn thành xác thực tên miền
- Cài đặt Python
Bỏ qua các điều kiện tiên quyết
Đăng ký tài khoản SendGrid
Khi bạn đăng ký tài khoản SendGrid miễn phí, bạn sẽ có thể gửi mãi mãi 100 email mỗi ngày. Để có thêm tùy chọn tài khoản, hãy xem trang định giá của chúng tôi
Bật xác thực hai yếu tố
Twilio SendGrid yêu cầu khách hàng kích hoạt Xác thực hai yếu tố [2FA]. Bạn có thể bật 2FA bằng SMS hoặc bằng ứng dụng Authy. Xem phần 2FA trong tài liệu xác thực của chúng tôi để biết hướng dẫn
Tạo và lưu trữ khóa API SendGrid
Không giống như tên người dùng và mật khẩu — thông tin đăng nhập cho phép truy cập vào tài khoản đầy đủ của bạn — khóa API được phép thực hiện một phạm vi hành động hạn chế. Nếu khóa API của bạn bị xâm phạm, bạn cũng có thể xoay vòng nó [xóa và tạo khóa khác] mà không thay đổi thông tin đăng nhập tài khoản khác của mình
Truy cập tài liệu về Khóa API của chúng tôi để biết hướng dẫn về cách tạo khóa API và lưu trữ khóa API trong biến môi trường. Để hoàn thành hướng dẫn này, bạn có thể tạo khóa API Truy cập bị hạn chế bằng Gửi thư > Chỉ có quyền truy cập đầy đủ, thao tác này sẽ cho phép bạn gửi email và lên lịch gửi email sau. Bạn có thể chỉnh sửa các quyền được gán cho khóa API sau để hoạt động với các dịch vụ bổ sung
Sau khi khóa API của bạn được gán cho một biến môi trường — bắt đầu nhanh này sử dụng
python --version
8 — bạn có thể chuyển sang bước tiếp theoexport SENDGRID_API_KEY=
Xác minh danh tính người gửi của bạn
Để đảm bảo khách hàng của chúng tôi duy trì danh tiếng người gửi tốt nhất có thể và duy trì hành vi gửi hợp pháp, chúng tôi yêu cầu khách hàng xác minh Danh tính người gửi của họ bằng cách hoàn thành Xác thực miền. Danh tính người gửi đại diện cho địa chỉ email 'Từ' của bạn—địa chỉ mà người nhận của bạn xem là người gửi email của bạn
Để bắt đầu nhanh chóng, bạn có thể bỏ qua Xác thực miền và bắt đầu bằng cách hoàn thành Xác minh một người gửi. Xác minh người gửi đơn chỉ được khuyến nghị để thử nghiệm. Một số nhà cung cấp dịch vụ email có chính sách DMARC hạn chế gửi email bằng miền của họ. Để có trải nghiệm tốt nhất, vui lòng hoàn tất Xác thực miền. Xác thực tên miền cũng được yêu cầu để nâng cấp từ tài khoản miễn phí
con trăn
Trước khi cài đặt Python, bạn có thể xem trên máy của mình đã có phiên bản chưa
Thư viện trợ giúp Twilio SendGrid Python hỗ trợ Python 2. 7, 3. 5, 3. 6, 3. 7 và 3. 8
Kiểm tra phiên bản Python
Kiểm tra phiên bản Python của bạn bằng cách mở thiết bị đầu cuối [còn được gọi là dòng lệnh hoặc bảng điều khiển] và nhập lệnh sau
python --version
Nếu bạn đã cài đặt Python, thiết bị đầu cuối sẽ in một cái gì đó giống như đầu ra sau
Python 3.8.5
Mặc dù thư viện trợ giúp SendGrid hỗ trợ Python trở lại phiên bản 2. 7, chúng tôi khuyên bạn nên sử dụng 3. x hiện tại Python 2 đã đạt đến trạng thái cuối vòng đời
Có thể có nhiều phiên bản Python trên máy tính của bạn. Một số hệ điều hành đi kèm với phiên bản Python đã được cài đặt sẵn. Nếu bạn chạy
python --version
9 và nhận được Python 3.8.5
0 sau khi cài đặt Python 3, hãy thử chạy Python 3.8.5
1 để xem 3 nào. phiên bản x của Python mà bạn đã cài đặt. Hướng dẫn này sẽ sử dụng lệnh Python 3.8.5
2, giả sử bạn đang làm việc với Python 3. Nếu bạn chưa thiết lập Python 3 trong môi trường ảo, bạn có thể cần chạy lệnh Python 3.8.5
3 để thay thếĐể biết thêm về cách chạy nhiều phiên bản Python, hãy xem "Môi trường ảo và gói" trong tài liệu Python
Cài đặt Python
Nếu bạn chưa cài đặt phiên bản Python, hãy truy cập trang web Python để tải xuống và cài đặt phiên bản phù hợp với hệ điều hành của bạn
Bắt đầu dự án
Sử dụng thư viện trợ giúp Twilio SendGrid là cách nhanh nhất để gửi email đầu tiên của bạn
Bắt đầu bằng cách tạo một thư mục dự án cho ứng dụng này. Bạn có thể đặt tên cho dự án bất cứ điều gì bạn thích. Chúng tôi sử dụng
Python 3.8.5
4 trong các ví dụ sauexport SENDGRID_API_KEY=
0Tiếp theo, điều hướng vào thư mục sg_quickstart nơi bạn sẽ hoàn thành phần còn lại của hướng dẫn
export SENDGRID_API_KEY=
1Khởi tạo dự án của bạn
Trình quản lý gói pip được bao gồm khi bạn cài đặt Python. Bạn có thể sử dụng pip để cài đặt thư viện trợ giúp Twilio SendGrid và lưu nó dưới dạng phần phụ thuộc của dự án. Nếu bạn muốn xác minh rằng pip đã được cài đặt, bạn có thể nhập thông tin sau vào thiết bị đầu cuối
export SENDGRID_API_KEY=
2Thiết bị đầu cuối sẽ in một cái gì đó giống như đầu ra sau
export SENDGRID_API_KEY=
3Nếu bạn chưa cài đặt phiên bản pip, bạn có thể tải xuống và cài đặt nó bằng hướng dẫn cài đặt pip trên python. tổ chức
Cài đặt thư viện trợ giúp
Để cài đặt thư viện trợ giúp Twilio SendGrid, hãy nhập lệnh sau vào thiết bị đầu cuối
export SENDGRID_API_KEY=
4Thiết bị đầu cuối sẽ in một cái gì đó như
export SENDGRID_API_KEY=
5Cách gửi email API
Bây giờ bạn đã sẵn sàng để viết một số mã. Đầu tiên, tạo một tệp trong thư mục dự án của bạn. Bạn có thể sử dụng
Python 3.8.5
5Hoàn thành khối mã
Khối Python sau chứa tất cả mã cần thiết để gửi thư thành công với API gửi thư SendGrid. Bạn có thể sao chép mã này, sửa đổi các biến
Python 3.8.5
6 và Python 3.8.5
7 và chạy mã nếu muốn. Chúng tôi sẽ chia nhỏ từng đoạn mã này trong các phần sauexport SENDGRID_API_KEY=
9Xây dựng lệnh gọi API của bạn
Lệnh gọi API của bạn phải có các thành phần sau
- Máy chủ lưu trữ [máy chủ cho các yêu cầu API Web v3 luôn là
8]Python 3.8.5
- Khóa API được chuyển trong Tiêu đề ủy quyền
- Yêu cầu [khi gửi dữ liệu tới tài nguyên qua
9 hoặcPython 3.8.5
00, bạn phải gửi nội dung yêu cầu của mình ở định dạng JSON]export SENDGRID_API_KEY=
Trong tệp
Python 3.8.5
5 của bạn, hãy nhập thư viện trình trợ giúp SendGrid. Thư viện sẽ xử lý cài đặt Máy chủ, Python 3.8.5
8, cho bạnpython --version
0Tiếp theo, sử dụng khóa API bạn đã thiết lập trước đó. Hãy nhớ rằng, khóa API được lưu trữ trong một biến môi trường, vì vậy bạn có thể sử dụng phương pháp
export SENDGRID_API_KEY=
03 để truy cập nó. Điều này có nghĩa là chúng ta cũng cần nhập thư viện os của Pythonpython --version
1Gán khóa cho một biến có tên là
export SENDGRID_API_KEY=
04 bằng cách sử dụng phương thức export SENDGRID_API_KEY=
05 của thư viện trợ giúp. Thư viện trợ giúp sẽ chuyển khóa của bạn tới API v3 trong tiêu đề Ủy quyền bằng cách sử dụng xác thực mã thông báo Bearerpython --version
2Bây giờ bạn đã sẵn sàng thiết lập
Python 3.8.5
6, Python 3.8.5
7, export SENDGRID_API_KEY=
08 và nội dung thư export SENDGRID_API_KEY=
09. Các giá trị này được chuyển đến API trong đối tượng "cá nhân hóa" khi sử dụng API Gửi thư v3. Bạn có thể gán từng giá trị này cho các biến và thư viện SendGrid sẽ xử lý việc tạo đối tượng cá nhân hóa cho bạnĐầu tiên, nhập các lớp
export SENDGRID_API_KEY=
10, export SENDGRID_API_KEY=
11, export SENDGRID_API_KEY=
12 và export SENDGRID_API_KEY=
13 của thư việnpython --version
3Với các trình trợ giúp được nhập, xác định và gán giá trị cho các biến
Python 3.8.5
6, Python 3.8.5
7, export SENDGRID_API_KEY=
08 và export SENDGRID_API_KEY=
09. Chỉ định một địa chỉ email như export SENDGRID_API_KEY=
18 sẽ hoạt động. Tuy nhiên, các hàm tạo được nhập ở bước trước cho phép bạn truyền dữ liệu cho chúng để đảm bảo thông báo cuối cùng của bạn được định dạng đúng. Đảm bảo chỉ định Python 3.8.5
7 cho địa chỉ có hộp thư đến mà bạn có thể truy cậpLưu ý rằng trình trợ giúp
export SENDGRID_API_KEY=
20 có hai đối số. loại nội dung và chính nội dung. Bạn có hai tùy chọn cho loại nội dung. export SENDGRID_API_KEY=
21 hoặc export SENDGRID_API_KEY=
22. Tham số thứ hai sẽ lấy văn bản thuần túy hoặc nội dung HTML mà bạn muốn gửipython --version
4Để xây dựng thư đúng cách, hãy chuyển từng biến trước đó vào hàm tạo Thư của thư viện SendGrid. Bạn có thể gán giá trị này cho một biến có tên là
export SENDGRID_API_KEY=
23. Sau đó, bạn có thể sử dụng phương thức export SENDGRID_API_KEY=
24 của hàm tạo Thư để nhận biểu diễn sẵn sàng JSON của đối tượng Thưpython --version
5Cuối cùng, bạn cần gửi yêu cầu tới SendGrid Mail Send API để gửi thư của bạn
Thư viện trợ giúp sử dụng thư viện python-http-client của SendGrid để tạo URL yêu cầu bằng cách xâu chuỗi các phần của đường dẫn mong muốn của bạn. Đường dẫn đến điểm cuối SendGrid v3 Mail Send là
export SENDGRID_API_KEY=
25. Thư viện trợ giúp đặt ứng dụng khách cho bạn, vì vậy phần export SENDGRID_API_KEY=
26 được xử lý bằng cách nhập export SENDGRID_API_KEY=
27. Các phần tiếp theo của đường dẫn là export SENDGRID_API_KEY=
28 và export SENDGRID_API_KEY=
29. Bạn có thể xâu chuỗi các từ export SENDGRID_API_KEY=
23 và export SENDGRID_API_KEY=
31 vào export SENDGRID_API_KEY=
32 để tạo phần còn lại của URLVới URL được tạo, python-http-client sau đó cho phép bạn xâu chuỗi loại yêu cầu HTTP mà bạn muốn thực hiện bằng một phương thức khớp với tên của động từ HTTP phù hợp với điểm cuối mong muốn của bạn. Để gửi tin nhắn, bạn nên thực hiện yêu cầu HTTP
Python 3.8.5
9, vì vậy bạn có thể sử dụng export SENDGRID_API_KEY=
34. Phương thức export SENDGRID_API_KEY=
34 nhận một export SENDGRID_API_KEY=
36, mà bạn nên đặt thành phiên bản JSON của tin nhắn [hãy nhớ rằng phiên bản sẵn sàng cho JSON này được lưu trữ trong biến export SENDGRID_API_KEY=
37]. Bạn có thể gán cuộc gọi đầy đủ này cho một biến có tên là export SENDGRID_API_KEY=
38 và in mã trạng thái phản hồi và các tiêu đềpython --version
6Với tất cả mã này, bạn có thể chạy tệp
Python 3.8.5
5 của mình bằng Python để gửi emailpython --version
7Nếu bạn nhận được mã trạng thái
export SENDGRID_API_KEY=
40 được in trên bảng điều khiển, tin nhắn của bạn đã được gửi thành công. Kiểm tra hộp thư đến của địa chỉ export SENDGRID_API_KEY=
41 và bạn sẽ thấy tin nhắn demo của mìnhNếu bạn không thấy email, bạn có thể cần kiểm tra thư mục thư rác của mình
Xử lý sự cố
Nếu nhận được thông báo lỗi, bạn có thể tham khảo tài liệu về thông báo phản hồi của chúng tôi để biết manh mối về những gì có thể đã sai
Thông báo phản hồi API
Tất cả các phản hồi được trả về ở định dạng JSON. Chúng tôi chỉ định điều này bằng cách gửi tiêu đề Loại nội dung. API Web v3 cung cấp lựa chọn mã phản hồi, tiêu đề kiểu nội dung và tùy chọn phân trang để giúp bạn diễn giải các phản hồi đối với các yêu cầu API của mình
Nhận hỗ trợ giới thiệu bổ sung. Tiết kiệm thời gian, nâng cao chất lượng gửi của bạn và cảm thấy tự tin rằng bạn đã sẵn sàng để đạt được thành công lâu dài với Dịch vụ triển khai SendGrid
Bước tiếp theo
Đây mới chỉ là khởi đầu của những gì bạn có thể làm với các API của chúng tôi. Để tìm hiểu thêm, hãy kiểm tra các tài nguyên bên dưới
- Tham chiếu API
- Gửi email với các mẫu giao dịch động
- Bắt đầu với Webhook sự kiện
- Nguồn cấp dữ liệu hoạt động email
- Xác thực người gửi
- Thư viện trợ giúp Twilio SendGrid cho Python
đánh giá trang này
1 2 3 4 5
Cần giúp đỡ?
tất cả chúng ta đôi khi làm. Nhận trợ giúp ngay bây giờ từ Nhóm hỗ trợ Twilio SendGrid
Chạy vào một rào cản mã hóa?