控制台

快速查看系统状态和常用功能

已创建邮箱

0

支持域名

0

API 状态

正常

域名分类

4 类

快速操作

已保存的邮箱 0

所有创建的邮箱会自动保存，刷新页面后也不会丢失。数据保存在服务器上。
邮箱地址 域名 服务 操作
暂无已保存的邮箱

点击左侧 "创建邮箱" 或下方 "快速创建邮箱" 开始使用

域名管理

查看和管理所有可用的邮箱域名

可用域名列表

0 个
# 域名 类别 类型 可用 操作
加载中...

创建临时邮箱

创建一个临时邮箱用于接收邮件

支持字母、数字、下划线、减号

邮件查看

查看指定邮箱的收件列表

收件箱

0 封

请先输入邮箱地址并点击获取邮件

批量操作

批量创建多个临时邮箱

支持 1-50 个

API 服务状态

查看各 API 服务的运行状态

Public API

检测中...

api.internal.temp-mail.io

HD API

检测中...

mail-server.1timetech.com

Gmail API

检测中...

mail-server-2.1timetech.com

系统信息

系统名称： Instant Mail API 管理系统
版本号： 2.0.0
时区： Asia/Shanghai
开源链接 https://github.com/ChiZhu-DL/Instant-Mail-Api

API 接口文档

支持网页内调用和 curl / 脚本直接调用

认证方式

方式一：网页内调用（自动 CSRF）

通过本页面操作时，系统自动处理 CSRF 令牌，无需额外配置。

方式二：curl / 脚本调用（API Key）

通过 X-API-Key 请求头传入 API 密钥，即可绕过 CSRF 验证：

curl -X POST "http://你的域名/api.php?action=create_email" \ -H "X-API-Key: tmpmail_ad75cf7bb1679ba2f334446f6a865f10" \ -d "domain=bltiwd.com"

接口列表

GET api.php?action=get_domains

获取所有可用的域名列表

参数：
  • category - 可选，按类别筛选 (public/hd/hot/google)
  • refresh - 可选，是否强制刷新缓存 (1/0)

POST api.php?action=create_email

创建一个临时邮箱

参数：
  • domain - 可选，指定域名
  • name - 可选，自定义用户名

POST api.php?action=create_gmail

创建 Gmail 类邮箱（实验性功能）

GET api.php?action=get_messages&email=xxx

获取指定邮箱的邮件列表

参数：
  • email - 必填，邮箱地址

POST api.php?action=delete_email

删除指定邮箱

参数：
  • email - 必填，邮箱地址
  • token - 必填，删除令牌

POST api.php?action=batch_create

批量创建多个邮箱

参数：
  • count - 必填，数量 (1-50)
  • domain - 可选，指定域名

GET api.php?action=get_stats&email=xxx

获取邮箱统计信息

GET api.php?action=get_status

获取各 API 服务状态

GET api.php?action=get_categories

获取域名分类信息

GET api.php?action=quick_create

快速创建邮箱（简化接口）

POST api.php?action=clear_cache

清除系统缓存

响应格式

{
  "success": true,
  "email": "example@bltiwd.com",
  "token": "your-token-here",
  "domain": "bltiwd.com",
  "service": "public"
}

curl 调用示例

创建邮箱

curl -X POST "http://你的域名/api.php?action=create_email" \
  -H "X-API-Key: tmpmail_ad75cf7bb1679ba2f334446f6a865f10" \
  -d "domain=bltiwd.com"

获取域名列表

curl "http://你的域名/api.php?action=get_domains"

获取邮件

curl "http://你的域名/api.php?action=get_messages&email=xxx@bltiwd.com"

获取已保存邮箱

curl "http://你的域名/api.php?action=get_stored_emails"

删除邮箱

curl -X POST "http://你的域名/api.php?action=delete_email" \
  -H "X-API-Key: tmpmail_ad75cf7bb1679ba2f334446f6a865f10" \
  -d "email=xxx@bltiwd.com&token=your-token"

批量创建

curl -X POST "http://你的域名/api.php?action=batch_create" \
  -H "X-API-Key: tmpmail_ad75cf7bb1679ba2f334446f6a865f10" \
  -d "count=5&domain=bltiwd.com"

测试 API 是否可用

curl -X POST "http://你的域名/api.php?action=get_status" \
  -H "X-API-Key: tmpmail_ad75cf7bb1679ba2f334446f6a865f10"

PHP 调用示例

创建邮箱（POST）

<?php

$api_key = 'tmpmail_ad75cf7bb1679ba2f334446f6a865f10';
$url = 'http://你的域名/api.php?action=create_email';
$data = ['domain' => 'bltiwd.com'];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: ' . $api_key]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result && $result['success']) {
    echo '邮箱: ' . $result['email'] . "\n";
    echo '令牌: ' . $result['token'] . "\n";
}

获取邮件（GET）

<?php

$email = 'example@bltiwd.com';
$url = 'http://你的域名/api.php?action=get_messages&email=' . urlencode($email);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result && $result['success']) {
    foreach ($result['messages'] as $msg) {
        echo '主题: ' . $msg['subject'] . "\n";
        echo '发件人: ' . $msg['from'] . "\n";
        echo "---\n";
    }
}

获取域名列表（GET）

<?php

$url = 'http://你的域名/api.php?action=get_domains';
$response = file_get_contents($url);
$result = json_decode($response, true);
if ($result && $result['success']) {
    foreach ($result['data'] as $domain) {
        echo $domain['domain'] . ' - ' . $domain['category'] . "\n";
    }
}

批量创建（POST）

<?php

$api_key = 'tmpmail_ad75cf7bb1679ba2f334446f6a865f10';
$url = 'http://你的域名/api.php?action=batch_create';
$data = ['count' => 3, 'domain' => 'bltiwd.com'];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: ' . $api_key]);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

API Key 获取与使用

什么是 API Key？

API Key 是系统为脚本调用生成的安全密钥，用于绕过网页的 CSRF 验证。每个部署环境的 API Key 都不同。

如何获取 API Key？

API Key 基于部署路径自动生成，在本页面上方的 认证方式 区域可以看到您的 API Key：

您的 API Key: tmpmail_ad75cf7bb1679ba2f334446f6a865f10

或直接查看 config.php 中的 API_SECRET_KEY 常量定义。

如何使用？

在 POST 请求的 HTTP Header 中添加：

X-API-Key: tmpmail_ad75cf7bb1679ba2f334446f6a865f10

以下操作需要 API Key：

  • 创建邮箱 (create_email)
  • 批量创建 (batch_create)
  • 删除邮箱 (delete_email)
  • 清除缓存 (clear_cache)
  • 手动添加邮箱 (add_email)
  • 清空邮箱列表 (clear_emails)
  • 删除邮箱记录 (remove_email_record)

以下操作 不需要 API Key（公开接口）：

  • 获取域名列表 (get_domains)
  • 获取邮件 (get_messages)
  • 获取已保存邮箱 (get_stored_emails)
  • 查看 API 状态 (get_status)
  • 获取域名分类 (get_categories)
  • 查看系统基本信息 (不带 action 的请求)