本地邮件工具API文档

检查邮箱状态 获取邮件内容 批量扫描锁定账号

📢 获取工具

如需使用本地邮件工具，请立即联系客服获取

使用说明

第一步：启动本地服务

运行 本地取件.exe 程序，将启动本地服务，监听5000端口。

第二步：调用API接口

服务启动后，您可以使用以下API接口：

1. 检查邮箱状态

GET http://127.0.0.1:5000/?email=邮箱地址

检查邮箱账号是否被锁定或包含验证码。

请求参数

参数名 类型 必填 说明
email 字符串 是 要检查的邮箱地址

返回结果

返回结果中的 data.type 字段表示状态：

返回示例

找到验证码：

{
    "data": {
        "code": "759VBB",
        "date": "Thu, 14 Aug 2025 15:40:00 +0000 (UTC)",
        "message": "验证码已找到",
        "type": 1
    },
    "status": 1
}

账号被锁定：

{
    "data": {
        "code": "",
        "date": "Thu, 14 Aug 2025 15:30:01 +0000 (UTC)",
        "message": "疑是被锁号",
        "type": -1
    },
    "status": 1
}

未找到验证码：

{
    "data": {
        "code": "",
        "date": "",
        "message": "正常",
        "type": 0
    },
    "status": 1
}

2. 获取邮件内容

GET http://127.0.0.1:5000/list?email=邮箱地址

获取指定邮箱的邮件内容列表。

请求参数

参数名 类型 必填 说明
email 字符串 是 要查询的邮箱地址

返回示例

{
    "data": [
        {
            "body": "邮箱内容",
            "date": "Sat, 16 Aug 2025 03:47:30 +0000 (UTC)",
            "from": "\"Battle.net\" ",
            "subject": "Correo de verificación de cuenta de Battle.net - Acción requerida",
            "timestamp": 1755317368.427271,
            "to": "QTMPJGJH80964@OUTLOOK.COM"
        },
        {
            "body": "邮箱内容",
            "date": "Tue, 12 Aug 2025 14:49:27 +0800",
            "from": "Outlook 团队",
            "subject": "欢迎使用你的新 Outlook.com 帐户",
            "timestamp": 1754981367,
            "to": "Horne Eric "
        }
    ],
    "message": "读取成功（最新邮件在前）",
    "status": 1
}

3. 批量扫描锁定账号

GET http://127.0.0.1:5000/path?path=文件路径&num=线程数

批量扫描文本文件中的多个邮箱账号，检查是否被锁定。

请求参数

参数名 类型 必填 说明
path 字符串 是 包含邮箱账号的文本文件路径
num 整数 否 使用的线程数（默认：30，最小：10，最大：100）

返回示例

{
    "data": {
        "threads_used": 50,
        "total_emails": 50
    },
    "message": "已开始处理任务",
    "status": 1
}

结果文件：

补充说明

文件格式：批量扫描的输入文件应每行包含一个邮箱账号。每行可以是 邮箱----附加信息 格式或仅邮箱地址。

状态检查：您可以通过以下接口检查批量扫描的处理状态：

GET http://127.0.0.1:5000/status