Email API là gì và khi nào nên dùng

Gửi thư giao dịch bằng một lệnh gọi HTTP. Trang này giúp bạn chọn giữa Email API và Email Relay, và chỉ chỗ tra cứu tham số đầy đủ.

Email API dùng để ứng dụng của bạn gửi thư, không phải để người ngồi gõ thư. Thư xác nhận đơn hàng, mã OTP, thư đặt lại mật khẩu — những thư sinh ra từ mã nguồn.

Nó khác Email Business ở đâu

	Email Business	Email API
Ai gửi	con người, qua webmail hoặc Outlook	mã nguồn của bạn
Có hộp thư đến không	có	không — chỉ gửi
Đụng bản ghi MX gốc	có	không
Thư đến của tên miền	về Cloudfly	không đổi, vẫn ở chỗ cũ

Điểm cuối là điều nhiều người ngạc nhiên nhất: bật Email API không làm bạn mất hộp thư đang dùng. Bạn có thể dùng thư công ty ở một nhà cung cấp khác và vẫn gửi thư giao dịch qua Cloudfly.

Email API hay Email Relay

Hai dịch vụ gửi cùng một đường, chỉ khác cách ứng dụng của bạn nối vào.

	Email API	Email Relay
Giao thức	HTTP	SMTP
Hợp với	mã bạn tự viết, dịch vụ mới	phần mềm sẵn có chỉ biết SMTP
Xác thực bằng	khoá API trong header	tên đăng nhập và mật khẩu SMTP
Sửa mã nguồn	có, một lệnh gọi HTTP	thường không, chỉ đổi cấu hình

Quy tắc chọn nhanh:

Đang viết mới, hoặc đang gọi được HTTP → Email API
Có sẵn WordPress, ERP, phần mềm kế toán chỉ điền được host/port/user/pass → Email Relay

Hai dịch vụ có tài khoản, tên miền, khoá và hạn mức riêng. Bật cả hai thì phải cấu hình cả hai — tên miền đã xác minh cho dịch vụ này không tự sang dịch vụ kia, trừ bản ghi xác minh sở hữu vốn dùng chung.

Đường đi từ đầu tới thư đầu tiên

Xác minh quyền sở hữu tên miền — chung cho cả bốn dịch vụ
Cắm bản ghi cho tên miền gửi — ký thư và đường phản hồi
Tạo khoá API
Gửi thư đầu tiên

Sau đó là hai việc nên làm sớm, không bắt buộc để gửi được: nhận sự kiện qua webhook và đọc danh sách chặn.

Tra cứu tham số đầy đủ ở đâu

Tài liệu tham chiếu API nằm trong bảng điều khiển

Bảng điều khiển có mục Email API → Hướng dẫn. Đó là nơi có danh sách tham số đầy đủ, bảng mã lỗi HTTP, hạn mức theo gói, danh sách sự kiện webhook và mã mẫu — luôn khớp với tài khoản bạn đang đăng nhập, kể cả các con số theo gói.

Tài liệu này cố ý không chép lại bảng đó. Hai nơi cùng liệt kê tham số thì sớm muộn sẽ lệch nhau, và người đọc không có cách nào biết bên nào đúng.

Ranh giới giữa hai nơi:

Bạn cần	Đọc ở
Danh sách tham số, mã lỗi, hạn mức, mã mẫu	Hướng dẫn trong bảng điều khiển
Cách thiết lập lần đầu, chọn loại khoá, xử lý sự cố	tài liệu này

Giới hạn cần biết trước

Email API chỉ gửi. Muốn nhận thư ở tên miền đó thì dùng dịch vụ khác cho chiều nhận.
Địa chỉ from phải thuộc tên miền đã kích hoạt trong Email API. Không có ngoại lệ.
Có hạn mức theo gói cho số thư mỗi ngày, số khoá và số webhook. Con số chính xác của gói bạn đang dùng hiện trong bảng điều khiển.