API Documentation

// EmailFake - Gmail Edu (không cần password)
fetch('https://smail1s.com/get_messages', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    mode: 'emailfake',
    data: 'user@emailfake.com'
  })
}).then(r => r.json());

{
  "data": [
    {
      "email": "user@emailfake.com",
      "error": null,
      "mailSource": "emailfake",
      "messages": [
        {
          "uid": "a1b2c3d4e5f678901234567890123456",
          "from": "Meta",
          "subject": "Your Instagram code",
          "date": "2026-05-23T10:30:00.000Z",
          "code": "654321"
        }
      ]
    }
  ]
}

// Lấy chi tiết 1 email
fetch('https://smail1s.com/api/emailfake/detail', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    email: "user@emailfake.com",
    uid: "a1b2c3d4e5f678901234567890123456",
    subject: "Your Instagram code",
    from: "Meta"
  })
}).then(r => r.json());

{
  "success": true,
  "detail": {
    "subject": "Your Instagram code",
    "from": "Meta",
    "bodyHtml": "<div>...full HTML content...</div>",
    "bodyText": "Your Instagram verification code is 654321...",
    "code": "654321"
  }
}

// socket.emit('email:subscribe', 'user@emailfake.com')
// socket.on('email:new', (data) => { ... })

{
  "email": "user@emailfake.com",
  "uid": "f1e2d3c4b5a697801234567890123456",
  "from": "Meta",
  "subject": "Your Instagram code",
  "body": "<div>...</div>",
  "code": "654321",
  "isHtml": true,
  "timestamp": "2026-05-23T10:35:00.000Z"
}

// 1. Kết nối Socket.io
const socket = io('https://smail1s.com');

// 2. Subscribe email
socket.emit('email:subscribe', 'user@emailfake.com');

// 3. Gửi known_uids (tránh thông báo lại email đã load)
socket.emit('email:known_uids', {
  email: 'user@emailfake.com',
  uids: ['abc123', 'def456']
});

// 4. Lắng nghe email mới
socket.on('email:new', (data) => {
});

// 5. Fallback: HTTP polling khi không có Socket.io
async function pollEmail(email) {
  const res = await fetch('https://smail1s.com/get_messages', {
    method: 'POST',
    body: JSON.stringify({ mode: 'emailfake', data: email })
  });
  return res.json();
}
setInterval(() => pollEmail('user@emailfake.com'), 12000); // 12s

fetch('https://smail1s.com/api/check-tiktok-single', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    line: 'tiktok_user|password123',
    useProxy: true,
    proxyKey: '31.59.20.176:6754:username:password'
  })
}).then(r => r.json());

{
  "success": true,
  "account": "tiktok_user|password123",
  "status": "live",
  "message": "LIVE"
}

{
  "success": false,
  "message": "Thiếu dữ liệu tài khoản để check!"
}

{
  "success": false,
  "message": "Lỗi server: ..."
}

// Batch check TikTok - parallel requests
async function checkAllAccounts(accounts, proxies = []) {
  const results = await Promise.all(
    accounts.map((line, idx) => {
      const proxyKey = proxies[idx % proxies.length];
      return fetch('https://smail1s.com/api/check-tiktok-single', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
          line: line,
          useProxy: !!proxyKey,
          proxyKey: proxyKey || undefined
        })
      }).then(r => r.json());
    })
  );

  const live    = results.filter(r => r.status === 'live');
  const die     = results.filter(r => r.status === 'die');
  const unknown = results.filter(r => r.status === 'unknown');

  return { live, die, unknown, all: results };
}

// Usage
const accounts = ['user1', 'user2|password', 'user3|pass|email@x.com|pwd|refresh|clientid'];
const proxies  = ['31.59.20.176:6754:user:pass'];
checkAllAccounts(accounts, proxies);

fetch('https://smail1s.com/api/v2/mail/domains')
  .then(r => r.json())
  .then(console.log);

{
  "success": true,
  "domains": ["smail1s.com"]
}

// Create random email
fetch('https://smail1s.com/api/v2/mail/create', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({})
}).then(r => r.json());

// Create custom email
fetch('https://smail1s.com/api/v2/mail/create', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    mailbox: 'mytest123',
    domain: 'smail1s.com'
  })
}).then(r => r.json());

{
  "success": true,
  "email": "a1b2c3d4e5f6@smail1s.com",
  "expiresAt": "2026-08-13T10:45:00.000Z"
}

fetch('https://smail1s.com/api/v2/mail/inbox', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    email: 'a1b2c3d4e5f6@smail1s.com'
  })
}).then(r => r.json());

{
  "messages": [
    {
      "uid": 42,
      "subject": "Your verification code",
      "from": "Google <no-reply@google.com>",
      "date": "2026-08-13T10:30:00.000Z",
      "preview": "Your verification code is 456745...",
      "hasAttachments": false
    }
  ]
}

fetch('https://smail1s.com/api/v2/mail/detail', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    email: 'a1b2c3d4e5f6@smail1s.com',
    uid: 42
  })
}).then(r => r.json());

{
  "uid": 42,
  "subject": "Your verification code",
  "from": "Google <no-reply@google.com>",
  "to": "a1b2c3d4e5f6@smail1s.com",
  "cc": "",
  "replyTo": "",
  "date": "2026-08-13T10:30:00.000Z",
  "html": "<div>Your verification code is <strong>456745</strong></div>",
  "text": "Your verification code is 456745",
  "attachments": []
}

// Response is plain text (NOT JSON), use .text()
const otp = await fetch(
  'https://smail1s.com/api/v2/mail/otp?email=a1b2c3d4e5f6@smail1s.com'
).then(r => r.text());

456745

// ========== FLOW 1: Tách biệt (Create riêng + OTP riêng) ==========

// 1. Tạo mailbox
const { email } = await fetch('https://smail1s.com/api/v2/mail/create', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({})
}).then(r => r.json());

// 2. Đăng ký dịch vụ bên thứ 3
await registerThirdPartyService(email);

// 3. Đợi OTP (long-polling 60s)
const otp = await fetch(
  `https://smail1s.com/api/v2/mail/otp?email=${encodeURIComponent(email)}`
).then(r => r.text());

if (otp) {
  await verifyWithOTP(otp);
}

// ========== FLOW 2: Combined (tối ưu cho automation) ==========

// Tạo mailbox qua create-and-otp
const { email: email2 } = await fetch('https://smail1s.com/api/v2/mail/create-and-otp', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({})
}).then(r => r.json());

// Đăng ký dịch vụ với tracking param
await registerService({
  email: email2,
  callbackUrl: `https://app.com/verify?localPath=${encodeURIComponent(email2)}`
});

// Đợi OTP - có thể gọi ngay sau khi đăng ký
const otp2 = await fetch(
  `https://smail1s.com/api/v2/mail/otp?email=${encodeURIComponent(email2)}`
).then(r => r.text());

if (otp2) {
  await verifyWithOTP(otp2);
}

// ========== FLOW 3: Kiểm tra inbox thủ công ==========

// Lấy danh sách email
const { messages } = await fetch('https://smail1s.com/api/v2/mail/inbox', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ email: email })
}).then(r => r.json());

// Đọc chi tiết email đầu tiên
if (messages.length > 0) {
  const detail = await fetch('https://smail1s.com/api/v2/mail/detail', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      email: email,
      uid: messages[0].uid
    })
  }).then(r => r.json());

}