Lấy mã OTP bằng hai dòng lệnh.

Bắt đầu nhanh

Việc thường gặp nhất: tạo một địa chỉ, chờ mã xác minh gửi tới, đọc mã. Đúng hai request.

1. 1

   Xin một địa chỉ

   Bỏ trống user thì hệ thống sinh ngẫu nhiên 10 ký tự; bỏ trống luôn domain thì bốc ngẫu nhiên một domain đang mở.

   Chép

   curl "https://mailicloud.store/api/address?domain=mailicloud.store"

   {"address":"k3n8fq2wla@mailicloud.store"}

2. 2

   Đọc hòm thư kèm nội dung

   Dùng địa chỉ đó đi đăng ký ở đâu cần, rồi gọi lệnh này. html=0 bỏ phần HTML cho nhẹ — tìm OTP thì chỉ cần bodyText.

   Chép

   curl "https://mailicloud.store/api/inbox?address=k3n8fq2wla@mailicloud.store&html=0"

   {
     "address": "k3n8fq2wla@mailicloud.store",
     "count": 1,
     "messages": [
       {
         "key": "6a81aaf2e7d7885b3d1af630ef18b047f2a6b38f4496672b2322eb5422c9df25",
         "messageId": "<abc123@shop.com>",
         "to": "k3n8fq2wla@mailicloud.store",
         "from": "no-reply@shop.com",
         "fromName": "Shop",
         "subject": "Mã xác minh của bạn",
         "bodyText": "Mã của bạn là 483920",
         "receivedAt": "2026-07-31T10:08:42Z"
       }
     ]
   }

Xác thực và giới hạn

API dùng được ngay không cần key. Key chỉ để gỡ hai giới hạn dưới đây.

Gửi key theo một trong hai cách, tuỳ cái nào tiện hơn:

curl "https://mailicloud.store/api/inbox?address=abc@mailicloud.store&key=KEY_CUA_BAN"

curl -H "Authorization: Bearer KEY_CUA_BAN" \
     "https://mailicloud.store/api/inbox?address=abc@mailicloud.store"

Key do quản trị viên tạo trong trang Cài đặt. Không có sẵn key nào cho khách tự đăng ký.

Toàn bộ endpoint

curl "https://mailicloud.store/api/address?domain=mailicloud.store&user=dat-ten-rieng"

{"address":"dat-ten-rieng@mailicloud.store"}

curl "https://mailicloud.store/api/inbox?address=abc@mailicloud.store&from=huawei&since=1754899200&html=0"

{
  "address": "abc@mailicloud.store",
  "count": 1,
  "messages": [
    {
      "key": "6a81aaf2e7d7885b3d1af630ef18b047f2a6b38f4496672b2322eb5422c9df25",
      "from": "no-reply@facebookmail.com",
      "fromName": "Facebook",
      "subject": "Mã xác minh của bạn",
      "otp": "483920",
      "bodyText": "Mã của bạn là 483920",
      "receivedAt": "2026-07-31T10:08:42Z"
    }
  ]
}

curl "https://mailicloud.store/api/messages?address=abc@mailicloud.store"

{
  "address": "abc@mailicloud.store",
  "count": 1,
  "messages": [
    {
      "key": "6a81aaf2e7d7885b3d1af630ef18b047f2a6b38f4496672b2322eb5422c9df25",
      "from": "no-reply@shop.com",
      "fromName": "Shop",
      "subject": "Mã xác minh của bạn",
      "snippet": "Mã của bạn là 483920",
      "hasHtml": true,
      "receivedAt": "2026-07-31T10:08:42Z"
    }
  ]
}

curl "https://mailicloud.store/api/message/6a81aaf2e7d7885b3d1af630ef18b047f2a6b38f4496672b2322eb5422c9df25"

curl -N "https://mailicloud.store/api/stream?address=abc@mailicloud.store"

: connected

event: mail
data: {"key":"6a81aaf2…","from":"no-reply@shop.com","subject":"Mã xác minh của bạn",…}

: heartbeat

Mã lỗi

Thân lỗi luôn có dạng {"error":"..."}.

Điều nên biết trước khi dùng thật