API cho nhà phát triển

Dùng API để tạo hộp thư tạm, đọc thư và gia hạn địa chỉ. Có giới hạn theo IP.

Tạo hộp thư

POST https://10genmail.com/api/inbox

Không cần body. Trả về địa chỉ mới và danh sách thư rỗng.

{
  "address": "quick-fox-abc123@10genmail.com",
  "slug": "quick-fox-abc123",
  "createdAt": 1234567890123,
  "expiresAt": 1234568490123,
  "ttlSeconds": 600,
  "messages": []
}

Giới hạn: 10 yêu cầu/phút/IP.

Lấy hộp thư

GET https://10genmail.com/api/inbox?address=...

Query: address (email đã URL-encode). Trả về hộp thư và thư, hoặc 404 nếu hết hạn.

{
  "address": "quick-fox-abc123@10genmail.com",
  "slug": "quick-fox-abc123",
  "createdAt": 1234567890123,
  "expiresAt": 1234568490123,
  "ttlSeconds": 420,
  "messages": [
    {
      "id": "msg-...",
      "from": { "name": null, "email": "sender@example.com" },
      "subject": "Hello",
      "text": "...",
      "html": null,
      "date": "...",
      "timestamp": 1234567900000
    }
  ]
}

Giới hạn: 120 yêu cầu/phút/IP.

Gia hạn hộp thư

POST https://10genmail.com/api/inbox/extend

Body: { "address": "..." }. Thêm 10 phút, tối đa 30 phút từ lúc tạo. Trả về hộp thư đã cập nhật.

Giới hạn: giống lấy (120/phút).

API email tạm cho nhà phát triển | 10genmail