本文将详细介绍如何使用接口盒子的免费API实现邮箱邮件获取功能,支持IMAP/POP3协议,适用于QQ邮箱、网易邮箱等主流邮箱服务。
https://cn.apihz.cn/api/mail/getmaillist.phpPOST 或 GET参数名 | 必填 | 说明 |
|---|---|---|
id | 是 | 用户中心数字ID(需注册获取) |
key | 是 | 用户中心通讯秘钥 |
是 | 邮箱地址(如:user@qq.com) | |
pwd | 是 | 邮箱密码(QQ/网易等需用授权码,配置指南) |
popimap | 是 | 协议类型:imap 或 pop3(不可填错) |
ip | 是 | 服务器地址(如QQ邮箱:imap.qq.com) |
port | 是 | 端口号(IMAP通常993,POP3通常995) |
ssl | 是 | 加密方式:ssl 或 tls |
page | 否 | 页码(默认1) |
num | 否 | 每页数量(默认10,最大30) |
注:
id和keyjson复制{
"code": 200, // 状态码(200成功,400错误)
"msg": "获取成功", // 操作消息
"num": 13, // 邮件总数
"data": { // 邮件列表
"data": [
{
"number": 13, // 邮件序号
"subject": "测试主题",// 邮件主题
"frommail": "sender@example.com", // 发件人邮箱
"fromname": "发件人名称",
"date": "2025-05-02 20:53:25", // 发送时间
"content": "邮件内容(含HTML格式)"
}
]
}
}bash复制https://cn.apihz.cn/api/mail/getmaillist.php?
id=10000000&
key=your_private_key&
mail=your_email@qq.com&
pwd=QQ邮箱授权码&
popimap=imap&
ip=imap.qq.com&
port=993&
ssl=ssl&
page=1&
num=10python运行复制import requests
url = "https://cn.apihz.cn/api/mail/getmaillist.php"
params = {
"id": "10000000", # 替换为你的ID
"key": "your_private_key", # 替换为你的KEY
"mail": "your_email@qq.com",
"pwd": "QQ邮箱授权码",
"popimap": "imap",
"ip": "imap.qq.com",
"port": 993,
"ssl": "ssl",
"page": 1,
"num": 10
}
response = requests.post(url, data=params)
print(response.json()) # 打印返回的JSON数据成功响应:
json复制{
"code": 200,
"msg": "获取成功",
"num": 13,
"data": {
"data": [
{
"number": 13,
"subject": "测试邮件",
"frommail": "sender@example.com",
"fromname": "张三",
"date": "2025-05-02 20:53:25",
"content": "这是一封测试邮件..."
}
]
}
}失败响应:
json复制{"code": 400, "msg": "通讯秘钥错误"}版权声明:本接口由接口盒子提供,免费用于非商业用途。更多API详见官网文档。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。