首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >通用邮箱邮件获取API教程:支持IMAP/POP3协议

通用邮箱邮件获取API教程:支持IMAP/POP3协议

原创
作者头像
用户9840656
发布2025-07-01 08:32:25
发布2025-07-01 08:32:25
1.6K0
举报

本文将详细介绍如何使用接口盒子的免费API实现邮箱邮件获取功能,支持IMAP/POP3协议,适用于QQ邮箱、网易邮箱等主流邮箱服务。


一、接口基本信息
  • 功能说明​:通过API获取邮箱收件箱中的邮件列表
  • 请求地址​:https://cn.apihz.cn/api/mail/getmaillist.php
  • 请求方式​:POSTGET
  • 协议支持​:IMAP / POP3
  • 参考文档​:官方文档

二、请求参数说明

参数名

必填

说明

id

用户中心数字ID(需注册获取)

key

用户中心通讯秘钥

mail

邮箱地址(如: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)

​:

  1. 需在接口盒子官网注册获取专属idkey
  2. QQ/网易邮箱密码需使用授权码​(在邮箱设置中生成)

三、返回参数说明
代码语言:javascript
复制
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请求示例
代码语言:javascript
复制
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请求示例
代码语言:javascript
复制
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. 返回结果示例

成功响应​:

代码语言:javascript
复制
json复制{
  "code": 200,
  "msg": "获取成功",
  "num": 13,
  "data": {
    "data": [
      {
        "number": 13,
        "subject": "测试邮件",
        "frommail": "sender@example.com",
        "fromname": "张三",
        "date": "2025-05-02 20:53:25",
        "content": "这是一封测试邮件..."
      }
    ]
  }
}

失败响应​:

代码语言:javascript
复制
json复制{"code": 400, "msg": "通讯秘钥错误"}

五、注意事项
  1. 授权码替代密码​:QQ/163等邮箱需使用授权码(在邮箱设置中生成)
  2. 协议与端口匹配​:
    • IMAP协议:端口通常为993(SSL)或143(TLS)
    • POP3协议:端口通常为995(SSL)或110(TLS)
  3. 频率限制​:公共ID/KEY有频次限制,私有KEY无每日上限
  4. 内容处理​:邮件内容可能包含HTML标签,需自行解析所需数据

版权声明​:本接口由接口盒子提供,免费用于非商业用途。更多API详见官网文档。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • ​一、接口基本信息​
  • ​二、请求参数说明​
  • ​三、返回参数说明​
  • ​四、调用示例​
    • 1. GET请求示例
    • 2. Python POST请求示例
    • 3. 返回结果示例
  • ​五、注意事项​
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档