本文将详细介绍如何使用接口盒子的免费API实现邮箱邮件获取功能，支持IMAP/POP3协议，适用于QQ邮箱、网易邮箱等主流邮箱服务。
一、接口基本信息
- 功能说明：通过API获取邮箱收件箱中的邮件列表
- 请求地址：
https://cn.apihz.cn/api/mail/getmaillist.php - 请求方式：
POST或GET - 协议支持：IMAP / POP3
- 参考文档：官方文档
二、请求参数说明
| 参数名 | 必填 | 说明 |
| 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和key- QQ/网易邮箱密码需使用授权码（在邮箱设置中生成）
三、返回参数说明
json
复制
{ "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格式）" } ] } }
四、调用示例
1. GET请求示例
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=10
2. Python POST请求示例
python
运行
复制
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数据
3. 返回结果示例
成功响应：
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": "通讯秘钥错误"}
五、注意事项
- 授权码替代密码：QQ/163等邮箱需使用授权码（在邮箱设置中生成）
- 协议与端口匹配：
- IMAP协议：端口通常为993（SSL）或143（TLS）
- POP3协议：端口通常为995（SSL）或110（TLS）
- 频率限制：公共ID/KEY有频次限制，私有KEY无每日上限
- 内容处理：邮件内容可能包含HTML标签，需自行解析所需数据
版权声明：本接口由接口盒子提供，免费用于非商业用途。更多API详见官网文档。
