Giới hạn

Tổng quan

• 1–5/giây

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

  Một nếu không có khóa; 2, 3 hoặc 5 với khóa từ một gói trả phí. Kiểm tra một lần mỗi giây là cách dùng đúng.

• 60/phút

  Yêu cầu API miễn phí, mỗi phút

  Tính theo từng địa chỉ IP, khi không dùng khóa. Gói trả phí không giới hạn số yêu cầu mỗi phút.

• 1.000/ngày

  Yêu cầu API miễn phí, mỗi ngày

  Tính theo từng địa chỉ IP, đặt lại lúc 00:00 UTC. Gói trả phí không giới hạn số yêu cầu mỗi ngày.

• 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

Miễn phí, khi không dùng khóa: 60 yêu cầu mỗi phút và 1.000 yêu cầu mỗi ngày, cho mỗi địa chỉ IP. Mọi lệnh gọi tới một hộp thư đều được tính — liệt kê hộp thư, đọc một thư, phần thân HTML của thư, một tệp đính kèm, một lần xóa — và mọi lệnh gọi công cụ MCP cũng vậy. Bộ đếm theo ngày được đặt lại lúc 00:00 UTC.

Trong phạm vi đó, một lượt đọc mỗi giây cho mỗi địa chỉ: thăm dò một hộp thư mỗi giây một lần là nhịp độ dự kiến.

Với một khóa API miễn phí, cùng hạn mức đó đi theo tài khoản của bạn thay vì địa chỉ IP — tiện khi lệnh gọi của bạn đến từ các địa chỉ thay đổi, như một CI runner. Tài khoản miễn phí có một khóa, và các hộp thư khóa đọc được liệt kê trong hộp thư của bạn. Tạo khóa miễn phí

Gói trả phí không bị giới hạn theo phút, cũng không bị giới hạn theo ngày. Gửi khóa của gói trả phí dưới dạng Authorization: Bearer và chỉ còn lại tốc độ theo từng địa chỉ của gói — 2, 3 hoặc 5 yêu cầu mỗi giây, trên mọi tên miền, tính theo từng tài khoản. Premium chỉ từ $12,99 mỗi tháng. Xem các gói

Hộp thư trên trang này không trừ vào hạn mức API miễn phí: một trang để mở sẽ tiếp tục kiểm tra thư mới bao lâu tùy bạn cầ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: rate_limited cho giới hạn theo phút hoặc theo địa chỉ, daily_limit_reached cho giới hạn theo ngày, kèm thời gian còn lại đến nửa đêm UTC. Mỗi phản hồi cho yêu cầu miễn phí đều cho biết bạn còn lại bao nhiêu: X-RateLimit-Remaining cho phút hiện tại, X-RateLimit-Daily-Remaining cho ngày hiện tại.

HTTP/1.1 429 Too Many Requests
Retry-After: 3600
X-RateLimit-Daily-Limit: 1000
X-RateLimit-Daily-Remaining: 0
Content-Type: application/json

{
  "error":   "daily_limit_reached",
  "message": "free daily limit reached: 1000 requests a day per IP address, resets at 00:00 UTC — paid plans have no daily cap",
  "upgrade": { "from": "$12.99/month", "url": "https://grabmail.io/pricing", … }
}

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 97 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 12.99/month (2.000 premium messages/month, 1 API key, 2 req/s per address, no per-minute or daily API cap); Pro USD 49.99/month (15.000 premium messages/month, 5 API keys, 3 req/s per address, no per-minute or daily API cap); Scale USD 99.99/month (36.000 premium messages/month, 20 API keys, 5 req/s per address, no per-minute or daily API cap).

Một đơn vị hạn mức là một thư nhận được ở một địa chỉ premium hoặc một địa chỉ premium mới được mở, tùy cái nào đến trước. Lượt đọc đầu tiên một địa chỉ bằng khóa hợp lệ sẽ giữ địa chỉ đó cho tài khoản; nó vẫn được giữ — và đọc lại thì miễn phí — cho đến khi được trả lại từ bảng điều khiển hoặc gói hết hạn. Không gói nào giới hạn số địa chỉ một tài khoản đang giữ.

Chúng được đọc qua cùng các endpoint, với khóa Authorization: Bearer từ một gói trả phí. Nếu không có, một địa chỉ premium sẽ trả về 404 — cùng câu trả lời như một tên miền chúng tôi không lưu trữ, một cách cố ý, để nhóm không thể bị liệt kê bằng cách đoán tên. Nếu có, 402 nghĩa là hạn mức đã hết và 403 nghĩa là một người đăng ký khác đang giữ địa chỉ đó. Bảng đầy đủ, cùng các lệnh gọi để kiểm tra khóa và liệt kê nhóm, có trong tài liệu tham khảo API.

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.