Giới hạn

Tổng quan

• 1/giây

  Yêu cầu API, theo từng địa chỉ

  Kiểm tra một lần mỗi giây là cách dùng đúng.

• 5ngày

  Thời gian lưu trữ tin nhắn

  Tính từ lúc đến, đã đọc hay chưa. Giới hạn cứng.

• 5MB

  Kích thước tin nhắn tối đa

  Bị từ chối ngay tại thời điểm SMTP, nên bên gửi được thông báo.

• ∞

  Số địa chỉ mỗi tên miền

  Không có gì được tạo trước, nên không có gì để đếm.

• 200

  Số tin nhắn trả về mỗi lần gọi

  Mặc định 50. Con số này giới hạn một phản hồi, không phải toàn bộ hộp thư: next sẽ duyệt qua phần còn lại, dù có bao nhiêu đi nữa.

• 0

  Tin nhắn gửi đi

  Không có endpoint gửi thư. Đó là chủ ý.

Giới hạn tần suất

Một yêu cầu mỗi giây, cho mỗi địa chỉ. Giới hạn tính theo hộp thư, không theo IP, nên một máy chạy CI dùng chung đang thăm dò hai mươi hộp thư khác nhau sẽ không tự cạnh tranh với chính nó.

Vượt giới hạn, bạn sẽ nhận 429 kèm header Retry-After tính bằng giây tròn. Không có hạn mức ngày, không hạn mức tháng và không cần quản lý tín dụng burst.

Có một giới hạn thứ hai, và nó được nêu rõ ở đây thay vì để bạn tự phát hiện: 1200 yêu cầu mỗi phút từ một địa chỉ nguồn. Đó chính xác là ví dụ hai mươi hộp thư mỗi giây ở trên, nên tự động hóa thông thường không bao giờ chạm tới — nó tồn tại để một máy chủ đơn lẻ không thể quét mười nghìn địa chỉ mỗi giây.

HTTP/1.1 429 Too Many Requests
Retry-After: 1
Content-Type: application/json

{
  "error":   "rate_limited",
  "message": "one request per second, per address"
}

Hãy giãn thời gian thử lại dựa theo Retry-After thay vì một khoảng nghỉ cố định. Nếu giới hạn thay đổi, đoạn mã đọc header đó vẫn tiếp tục hoạt động.

Kích thước tin nhắn

Tin nhắn tối đa 5 MB, tính cả tệp đính kèm. Giới hạn này được máy chủ mail áp dụng ngay trong phiên trao đổi SMTP, điều này quan trọng: máy chủ gửi được thông báo ngay lúc nó thử gửi, và báo lỗi thật cho người dùng của nó, thay vì tin nhắn biến mất không dấu vết.

Những gì được tính

Toàn bộ thư đã mã hóa — tiêu đề, phần văn bản và mọi tệp đính kèm, tất cả sau khi đã mã hóa MIME. Base64 làm tệp nhị phân phình to thêm khoảng một phần ba, nên một tệp khoảng 3,5 MB đã lấp đầy giới hạn.

Điều gì xảy ra trên đường truyền

Mã 552 tại thời điểm SMTP. Thư không bao giờ được lưu và không bao giờ xuất hiện trong hộp thư.

Tệp đính kèm mỗi thư

Hai mươi. Trên thực tế, giới hạn dung lượng luôn đến trước — nhưng một thư mang nhiều phần có tên tệp hơn hai mươi sẽ chỉ giữ hai mươi phần đầu tiên.

Thời gian lưu trữ

Một thư bị xóa sau 5 ngày kể từ khi đến, dù đã đọc hay chưa, và đồng hồ bắt đầu tính từ lúc thư đến chứ không phải lúc đọc lần đầu.

Mọi tin nhắn đều có expires_at, nên phía client không bao giờ phải tự tính ngày đó hay theo dõi chính sách.

Đây là giới hạn cứng, không phải một tùy chọn: không tham số, gói hay tài khoản nào kéo dài thêm được. Nếu có gì cần tồn tại lâu hơn khung thời gian này, hãy lấy về và lưu ở phía bạn.

Địa chỉ và tên miền

Số địa chỉ mỗi tên miền

Không giới hạn, và không được đếm. Vì hộp thư không bao giờ được tạo, nên không có danh sách nào để nó tăng lên.

Quy tắc phần trước @

Từ một đến 64 ký tự: chữ cái, chữ số, dấu chấm, dấu gạch ngang, gạch dưới và dấu cộng. Phải bắt đầu và kết thúc bằng chữ cái hoặc chữ số. Bất kỳ ký tự nào khác đều bị từ chối trước khi đến máy chủ mail, cả ở trình duyệt lẫn ở máy chủ.

Địa chỉ dạng cộng

name+tag@domain là một hộp thư riêng biệt ở đây, không phải một bí danh của name@domain. Đó là cố ý — thẻ tag là cách người dùng tách các lượt đăng ký, và gộp chúng lại sẽ hợp nhất những hộp thư vốn phải tách biệt.

Chữ hoa/thường

Mọi thứ đều được chuyển thành chữ thường. Name@ và name@ là cùng một hộp thư.

Tên miền tùy chỉnh

Không giới hạn số lượng bạn trỏ về đây. Mỗi tên miền cần bản ghi MX riêng.

Hạn mức của pool premium

Mọi điều ở trên mô tả dịch vụ miễn phí, và nó vẫn thế: các tên miền công cộng và tên miền của riêng bạn không có hạn mức thư hay giới hạn địa chỉ, ở bất kỳ gói nào.

Gói trả phí bổ sung 92 tên miền .com riêng, được giữ ngoài các danh sách chặn thư dùng một lần. Chỉ thư đến CÁC tên miền đó mới tính vào hạn mức: Premium USD 24/month (2.000 premium messages/month, 1 API key, 2 req/s); Pro USD 78/month (15.000 premium messages/month, 5 API keys, 3 req/s); Scale USD 148/month (36.000 premium messages/month, 20 API keys, 5 req/s).

Chúng được đọc qua cùng các endpoint, với khóa Authorization: Bearer. Không có khóa, một địa chỉ premium trả về 402 hoặc 403 — không bao giờ là hộp thư.

Sử dụng hợp lý

Không có hạn mức để bạn mua thêm, và không có gói nào nâng các con số này lên. Thay vào đó: nếu một nguồn duy nhất làm dịch vụ tệ đi cho mọi người khác, nó sẽ bị chặn.

Thăm dò hàng loạt

Hàng nghìn hộp thư được thăm dò mỗi giây từ một nguồn sẽ bị hạn chế tốc độ ở lớp biên trước khi tới được API.

Thư ồ ạt

Một máy chủ gửi mở quá nhiều kết nối SMTP một cách bất thường sẽ bị chặn trong mười phút. Người gửi bình thường không bao giờ tới gần mức đó.

Dùng chúng tôi làm máy chuyển tiếp

Bất khả thi chứ không phải bị cấm: máy chủ thư chỉ chấp nhận tin nhắn gửi đến các tên miền được lưu trữ ở đây, nên nó không thể chuyển tiếp đi bất cứ đâu.

Điều này không nhắm đến việc tự động hóa thông thường. Thăm dò mỗi giây, cả ngày, trên hàng nghìn hộp thư — đó là cách dùng dự kiến, không phải giới hạn cực đoan.