Lưu Vân Mail API

animee.tokyo
vibecoder.io.vn
luuvan.site
luuvan.indevs.in
locpnv.indevs.in
lhuniverse.io.vn
locpnv.click
locpnv.site
luuvan.online
edu.luuvan.site

Authorization: Bearer tm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Đăng ký API key mới
curl -X POST https://mail.luuvan.online/api/register \
  -H "Content-Type: application/json" \
  -H "Cookie: tempmail_user_session=..." \
  -d '{"name": "My Cool App"}'

// Phải đăng nhập trước (cookie session tự gửi)
const res = await fetch('https://mail.luuvan.online/api/register', {
  method: 'POST',
  credentials: 'include',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'My Cool App' })
});
const data = await res.json();
console.log(data.apiKey); // tm_xxxx... (lưu lại ngay!)

{
  "apiKey": "tm_ABCxyz123...",
  "username": "myuser",
  "rateLimit": 100,
  "rateLimitPeriod": "hour"
}

X-RateLimit-Limit: 100        # Tổng request được phép/giờ
X-RateLimit-Remaining: 95    # Request còn lại
X-RateLimit-Reset: 2025-01-01T... # Thời điểm reset

{
  "error": "Rate limit exceeded.",
  "limit": 100,
  "resetAt": "2025-01-01T12:00:00.000Z"
}

{ "error": "Mailbox not found or expired." }

curl https://mail.luuvan.online/health

{
  "ok": true,
  "domain": "luuvan.online",
  "domains": ["animee.tokyo", ...],
  "defaultTtlMinutes": 60,
  "maxTtlMinutes": 1440,
  "hasAdminPassword": true
}

curl -X POST https://mail.luuvan.online/mailboxes \
  -H "Authorization: Bearer tm_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prefix": "otp-test", "domain": "luuvan.online"}'

const res = await fetch('https://mail.luuvan.online/mailboxes', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer $\{API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ prefix: 'otp-test', domain: 'luuvan.online' })
});
const data = await res.json();

{
  "mailbox": {
    "address": "otp-test@luuvan.online",
    "label": "otp-test",
    "createdAt": "2025-01-01T12:00:00.000Z",
    "expiresAt": "2125-01-01T12:00:00.000Z"
  },
  "recoveryKey": "RK-xxxxxxxxxxxxxxxxxxxxxxxx"
}

curl https://mail.luuvan.online/mailboxes/otp-test%40luuvan.online \
  -H "Authorization: Bearer tm_YOUR_KEY"

curl https://mail.luuvan.online/mailboxes/otp-test%40luuvan.online/messages \
  -H "Authorization: Bearer tm_YOUR_KEY"

{
  "mailbox": { ... },
  "messages": [
    {
      "id": "abc123",
      "from": "noreply@example.com",
      "to": "otp-test@luuvan.online",
      "subject": "Your OTP code",
      "receivedAt": "2025-01-01T12:05:00.000Z"
    }
  ]
}

curl https://mail.luuvan.online/messages/abc123 \
  -H "Authorization: Bearer tm_YOUR_KEY"

{
  "message": {
    "id": "abc123",
    "from": "noreply@example.com",
    "to": "otp-test@luuvan.online",
    "subject": "Your OTP code",
    "text": "Your code is 482910",
    "html": "<p>Your code is <b>482910</b></p>",
    "receivedAt": "2025-01-01T12:05:00.000Z"
  }
}

curl -X POST https://mail.luuvan.online/mailboxes/otp-test%40luuvan.online/extend \
  -H "Authorization: Bearer tm_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ttlMinutes": 120}'

curl -X DELETE https://mail.luuvan.online/mailboxes/otp-test%40luuvan.online \
  -H "Authorization: Bearer tm_YOUR_KEY"

curl -X POST https://mail.luuvan.online/inbound/messages \
  -H "Authorization: Bearer tm_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"otp-test@luuvan.online","from":"sender@example.com","subject":"OTP","text":"Your code is 123456","messageId":"<unique@example.com>"}'

{ "stored": true }

curl -X POST https://mail.luuvan.online/api/mailboxes \
  -H "Content-Type: application/json" \
  -d '{"prefix":"guest-test","domain":"luuvan.online","ttlMinutes":60}'

{
  "address": "guest-test@luuvan.online",
  "expiresAt": "2025-01-01T13:00:00.000Z",
  "recoveryKey": "RK-xxxxxxxxxxxxxxxxxxxxxxxx"
}

curl https://mail.luuvan.online/api/inbox \
  -H "x-recovery-key: RK-xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "mailbox": { ... },
  "messages": [
    { "id": "abc123", "from": "sender@example.com", "subject": "OTP" }
  ]
}

curl https://mail.luuvan.online/api/inbox/messages/abc123 \
  -H "x-recovery-key: RK-xxxxxxxxxxxxxxxxxxxxxxxx"

curl https://mail.luuvan.online/api/auth/me \
  -H "Cookie: tempmail_user_session=..."

{ "totalMessages": 12 }

{
  "mailboxes": [
    {
      "address": "test@luuvan.online",
      "label": "test",
      "createdAt": "2025-01-01T12:00:00.000Z",
      "expiresAt": "2025-01-01T13:00:00.000Z",
      "recoveryKey": "RK-xxxx...",
      "active": true
    }
  ]
}

{
  "mailbox": { ... },
  "messages": [
    { "id": "...", "from": "...", "subject": "...", "receivedAt": "..." }
  ]
}

curl https://mail.luuvan.online/api/domains

{
  "domains": ["vibecoder.io.vn", "luuvan.site", ...],
  "pendingDomains": ["locpnv.site", ...]
}