临时邮箱,可自定义前缀,24h数据自动清除,保护隐私安全。支持文本,html内容获取。多格式开放对接。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 否 | 登录获取 |
| id | string | 否 | 邮箱前缀,第一次创建,再次请求获取邮件 |
| type | string | 否 | json/text,返回格式。默认json |
| lang | string | 否 | cn/en,返回语言。默认cn |
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功,服务器已成功处理了请求。 |
| 403 | 服务器拒绝请求。这可能是由于缺少必要的认证凭据(如API密钥)或权限不足。 |
| 404 | 请求的资源未找到。请检查您的请求地址是否正确。 |
| 429 | 请求过于频繁。您已超出速率限制,请稍后再试。 |
| 500 | 服务器内部错误。服务器在执行请求时遇到了问题。 |
此处将显示接口返回结果以及生成的URL...
返回示例:
部分邮箱发的件可能会有延迟,等待或刷新即可
第一次请求(创建邮箱)
{
"状态": true,
"消息": "邮箱创建成功,获取邮件请使用原id继续请求,邮件最多保留24小时,之后自动删除",
"收件邮箱": "test@096789.xyz",
"创建时间": "2026-03-28 15:28:54",
"过期时间": "2026-03-29 15:28:54"
}
再次请求(获取邮件):
{
"状态": true,
"消息": "获取邮件成功",
"收件邮箱": "test@096789.xyz",
"总邮件数": 1,
"未读邮件数": 0,
"邮件列表": [
{
"邮件ID": "9a00d6f6-f1b1-4f4f-a574-70675ea84f9e",
"发件人": "xy@wsyun.top",
"主题": "API收件测试1",
"内容": "收件成功1",
"HTML内容链接": "https:\/\/wsapi.top\/API\/log\/mail_log\/htmlfile\/69c7846be2b9a.html",
"发送时间": "2026-03-28 15:34:00",
"是否已读": "是"
}
]
}
<?php
$url = 'https://wsapi.top/API/mail.php';
$params = ['apikey' => 'YOUR_VALUE', 'id' => 'YOUR_VALUE', 'type' => 'YOUR_VALUE', 'lang' => 'YOUR_VALUE', ];
$url .= '?' . http_build_query($params);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
import requests
url = "https://wsapi.top/API/mail.php"
params = {
'apikey': 'YOUR_VALUE',
'id': 'YOUR_VALUE',
'type': 'YOUR_VALUE',
'lang': 'YOUR_VALUE',
}
response = requests.get(url, params=params)
print(response.text)
const url = new URL('https://wsapi.top/API/mail.php');
const params = {
'apikey': 'YOUR_VALUE',
'id': 'YOUR_VALUE',
'type': 'YOUR_VALUE',
'lang': 'YOUR_VALUE',
};
Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));
fetch(url)
.then(response => response.text())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));