MS OAuth2API

Appearance

📨 获取最新一封邮件 ​

方法: GET 或 POST
URL: /api/mail-new
描述: 获取最新的一封邮件。如果邮件中含有 6 位数字验证码，会自动提取。

参数说明:

  • refresh_token (必填): 用于身份验证的 refresh_token。
  • client_id (必填): 客户端 ID。
  • email (必填): 邮箱地址。
  • mailbox (必填): 邮箱文件夹，支持的值为 INBOX 或 Junk。
  • response_type (可选): 返回格式，支持的值为 json 或 html，默认为 json。

使用示例:

JavaScript (Fetch API):

javascript
// GET 请求
fetch('https://yourdomain.com/api/mail-new?refresh_token=your_refresh_token&client_id=your_client_id&email=your_email@example.com&mailbox=INBOX&response_type=json')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

// POST 请求
fetch('https://yourdomain.com/api/mail-new', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    refresh_token: 'your_refresh_token',
    client_id: 'your_client_id',
    email: 'your_email@example.com',
    mailbox: 'INBOX',
    response_type: 'json'
  })
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

📂 获取全部邮件 ​

方法: GET 或 POST
URL: /api/mail-all
描述: 获取全部邮件。如果邮件中含有 6 位数字验证码，会自动提取。

参数说明:

  • refresh_token (必填): 用于身份验证的 refresh_token。
  • client_id (必填): 客户端 ID。
  • email (必填): 邮箱地址。
  • mailbox (必填): 邮箱文件夹，支持的值为 INBOX 或 Junk。

使用示例:

JavaScript (Fetch API):

javascript
// GET 请求
fetch('https://yourdomain.com/api/mail-all?refresh_token=your_refresh_token&client_id=your_client_id&email=your_email@example.com&mailbox=INBOX')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

// POST 请求
fetch('https://yourdomain.com/api/mail-all', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    refresh_token: 'your_refresh_token',
    client_id: 'your_client_id',
    email: 'your_email@example.com',
    mailbox: 'INBOX'
  })
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

🗑️ 清空收件箱 ​

方法: GET 或 POST
URL: /api/process-inbox
描述: 清空收件箱。

参数说明:

  • refresh_token (必填): 用于身份验证的 refresh_token。
  • client_id (必填): 客户端 ID。
  • email (必填): 邮箱地址。

使用示例:

JavaScript (Fetch API):

javascript
// GET 请求
fetch('https://yourdomain.com/api/process-inbox?refresh_token=your_refresh_token&client_id=your_client_id&email=your_email@example.com')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

// POST 请求
fetch('https://yourdomain.com/api/process-inbox', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    refresh_token: 'your_refresh_token',
    client_id: 'your_client_id',
    email: 'your_email@example.com'
  })
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

🗑️ 清空垃圾箱 ​

方法: GET 或 POST
URL: /api/process-junk
描述: 清空垃圾箱。

参数说明:

  • refresh_token (必填): 用于身份验证的 refresh_token。
  • client_id (必填): 客户端 ID。
  • email (必填): 邮箱地址。

使用示例:

JavaScript (Fetch API):

javascript
// GET 请求
fetch('https://yourdomain.com/api/process-junk?refresh_token=your_refresh_token&client_id=your_client_id&email=your_email@example.com')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

// POST 请求
fetch('https://yourdomain.com/api/process-junk', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    refresh_token: 'your_refresh_token',
    client_id: 'your_client_id',
    email: 'your_email@example.com'
  })
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

📤 发送邮件 ​

方法: GET 或 POST
URL: /api/send-mail
描述: 发送邮件。支持纯文本（text）或 HTML 格式（html）的内容。

参数说明:

  • refresh_token (必填): 用于身份验证的 refresh_token。
  • client_id (必填): 客户端 ID。
  • email (必填): 发件人邮箱地址。
  • to (必填): 收件人邮箱地址。
  • subject (必填): 邮件主题。
  • text (可选): 邮件的纯文本内容（与 html 二选一）。
  • html (可选): 邮件的 HTML 内容（与 text 二选一）。
  • send_password (可选): 为增强接口安全性，防止滥用，现已支持密码验证功能。您可以通过在环境变量中配置 SEND_PASSWORD 来启用此功能。启用后，请求时需提供正确的 SEND_PASSWORD 参数方可访问。

使用示例:

JavaScript (Fetch API):

javascript
// GET 请求
fetch('https://yourdomain.com/api/send-mail?refresh_token=your_refresh_token&client_id=your_client_id&email=your_email@example.com&to=recipient@example.com&subject=Hello&text=This is a test email')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

// POST 请求
fetch('https://yourdomain.com/api/send-mail', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    refresh_token: 'your_refresh_token',
    client_id: 'your_client_id',
    email: 'your_email@example.com',
    to: 'recipient@example.com',
    subject: 'Hello',
    text: 'This is a test email', // 或者使用 html: '<p>This is a test email</p>'
  })
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));