接口线路类型一[集群IP接口]
[接口地址1]
：当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址2]
：当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址3]
：当前负载【
优】 接口通讯【
正常】
复制
测速
接口线路类型二[域名接口]
[接口地址]
：[自动分发到集群接口服务器，但可能因网络运营商DNS缓存如果某个集群节点发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]
复制
测速
接口线路类型三[VIP线路超高稳定-最低24¥/月]
[VIP线路]
：[专属集群+普通集群+备用集群，自动负载均衡，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！CC防火墙宽松。登录后购买。注：VIP线路是指调用接口的线路更有保障以及更高的调用频次限制等，并非收费接口包月使用。]
复制
测速
请求示例
[GET]请求示例：(以下为公共KEY，共享每分钟调用频次，请登录后使用自己的KEY独享频次)
复制全部
复制参数
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群500700444，及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 |
参数 |
必填 |
说明 |
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 操作类型 | type | 否 | 0=获取邮件，1=清空收件箱，2=生成随机邮箱，默认0.例：type=0 |
| 邮箱 | mail | 否 | 邮箱，读删邮件必传。例：mail=test@apimail.email |
| 密码 | pwd | 否 | 邮箱密码，读删邮件必传，生成邮箱优先使用自定义密码，否则默认随机生成。例：pwd=112234552 |
| 邮箱前缀 | mailname | 否 | 生成邮箱可传指定前缀名称，默认随机生成。例：mailname=testname |
| 页码 | page | 否 | 获取邮件列表页码，默认第1页，type=0时可指定此参数。例：page=1 |
| 动态秘钥 | 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": "清空邮箱邮件成功。"
}
示例：
{
"code": 400,
"msg": "邮件路径不存在"
}
示例：
{
"code": 200,
"msg": "删除成功"
}
更新记录
2025-09-05 11:18:48 - 新增接口。
定制接口-临时邮箱生成及读邮件删邮件-2025-12-11 18:03:02