线路类型一[普通集群负载-IP接口]
线路类型二[普通集群负载-域名接口]
说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。
线路类型三[VIP集群负载-VIP线路接口]
说明：VIP专属大带宽服务器集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低24¥/月，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。
请求示例
[GET]请求示例：(以下为公共KEY，共享每分钟调用频次，请登录后使用自己的KEY独享频次)
复制全部
复制参数
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群500700444，及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 |
参数 |
必填 |
说明 |
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 邮箱 | mail | 是 | 邮箱，例：mail=mail@apihz.cn |
| 密码 | pwd | 是 | 密码，注意QQ，网易邮箱等的密码是授权码，需要在邮箱设置里配置，请自行百度。例：pwd=123456 |
| 协议 | popimap | 是 | imap或pop3，只能传这两个值，不能填错，否则会造成超时，同时链接地址，端口，加密方式等必须与协议对应，常见邮箱的配置参数请参考：https://www.apihz.cn/article/d072d462a70d8b1efed3d3bea3290135.html。一般大型邮箱获取时间可能需要几秒，如果超时请多次尝试,网易必须使用pop3协议。各种邮箱必须开启POP3或IMAP服务，请在邮箱服务商处开通。例：popimap=imap |
| 链接地址 | ip | 是 | 链接地址，可以是IP，也可以是域名，例：ip=pop.qq.com |
| 链接端口 | port | 是 | 对应协议的链接端口，例：port=993 |
| 加密方式 | ssl | 是 | 传ssl或tls，例：ssl=ssl |
| 页码 | page | 否 | 邮件列表页码，默认1，例：page=1 |
| 每页数量 | num | 否 | 每页获取的邮件数量，默认5，最大不超过5，例：mail=mail@apihz.cn |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 |
参数 |
说明 |
| 状态码 | code | 200成功，400错误 |
| 消息内容 | msg | 返回提示。 |
| 邮件数量 | num | 邮箱收件箱总邮件数量。 |
| 邮件列表数据集 | data | 邮件列表数据集。 |
| 邮件序号 | data.number | 邮件序号。 |
| 邮件主题 | data.subject | 邮件主题。 |
| 发件人邮箱 | data.frommail | 发件人邮箱。 |
| 发件人名称 | data.fromname | 发件人名称。 |
| 时间 | data.date | 时间。 |
| 邮件内容 | data.content | 邮件内容。注意，现在大多邮件都会带HTML格式内容，请自行提取邮件里自己需要的内容。 |
返回数据示例
示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
"code": 200,
"msg": "获取成功",
"num": 13,
"data": {
"data": [
{
"number": 13,
"subject": "测试手机",
"frommail": "728528526@qq.com",
"fromname": "?无有",
"date": "2025-05-02 20:53:25",
"content": "啊啊啊巴巴爸爸\r\n\r\n\r\n?无有\r\n728528526@qq.com"
},
{
"number": 12,
"subject": "邮件发送测试。",
"frommail": "mail@erguanmingmin.com",
"fromname": "聚合联盟",
"date": "2025-05-02 17:06:20",
"content": "这是一封测试邮件！来自：https://pay.erguanmingmin.com/\r\n\r\n"
},
{
"number": 11,
"subject": "邮件发送测试。",
"frommail": "mail@erguanmingmin.com",
"fromname": "聚合联盟",
"date": "2025-05-02 17:06:31",
"content": "这是一封测试邮件！来自：https://pay.erguanmingmin.com/\r\n\r\n"
},
{
"number": 10,
"subject": "邮件发送测试。",
"frommail": "mail@erguanmingmin.com",
"fromname": "聚合联盟",
"date": "2025-05-02 17:06:26",
"content": "这是一封测试邮件！来自：https://pay.erguanmingmin.com/\r\n\r\n"
},
{
"number": 9,
"subject": "邮件发送测试。",
"frommail": "mail@erguanmingmin.com",
"fromname": "聚合联盟",
"date": "2025-05-02 17:05:58",
"content": "这是一封测试邮件！来自：https://pay.erguanmingmin.com/\r\n\r\n"
}
]
}
}
更新记录
2025-05-03 20:21:27 - 新增接口。
邮件短信-通用获取邮箱邮件-支持IMAP/POP3-2026-04-16 12:05:13
