API 文档

基础 URL：https://api.cybertemp.xyz免费层级具有标准处理速度；订阅以获得优先访问权限。

邮件检索

临时收件箱

多域名

订阅计划

获取免费 API 密钥查看价格

如何使用我们的 API（很简单！）

我们的 API 非常灵活！选择免费访问（稍有延迟）或订阅以获得即时访问。

公共 API：访问通用邮件数据

像 getMail 或 getDomains 这样的端点有两种模式：

标准速度： 需要 API 密钥，使用标准处理队列以确保每个人的公平使用。
闪电般快速（订阅用户）： 在您的 API 密钥使用 X-API-KEY 标头。这将根据您的订阅计划为您提供即时响应 和更高的限制。

X-API-KEY: your_subscription_api_key_here

公共 API：免费（标准）或即时（优先）

将其用于通用邮件数据。免费层级访问以标准速度处理。订阅以获得具有更高速率限制的即时优先访问权限。

Bearer 令牌（用于私有端点）

仅对私有端点 Authorization: Bearer <token> 使用仅请求头 /private/emails。在您的仪表板中生成此令牌。它将您作为特定用户进行身份验证，以通过 API 访问您的个人邮件。

Authorization: Bearer your_generated_dashboard_token_here

私有端点访问

Bearer 令牌将 API 请求直接链接到您的用户帐户，允许访问与您的私有地址关联的邮件。从仪表板获取您的令牌。

如何获取 API 密钥

API 密钥对所有用户可用。注意：只有当 API 密钥链接到活跃的付费订阅计划时，才会授予即时/无延迟访问权限 - 否则请求将被视为公共请求（受标准速度和免费层级速率限制）。

登录您的帐户

使用您的电子邮件和密码登录您的 CyberTemp 帐户。

访问设置

单击右上角的个人资料头像，然后从下拉菜单中选择“设置”。

生成 API 密钥

向下滚动到“API 密钥”部分，然后单击“生成新密钥”按钮。复制并安全地存储您的 API 密钥。

转到设置以管理 API 密钥

API 访问：超简单指南

公共 API（通用邮件，域名）：使用 X-API-KEY = 免费（非优先队列）。使用活跃付费订阅 = 优先（即时）。

私有端点 (/private/emails): 使用 Authorization: Bearer <token> (必需)。

Bearer 令牌在仪表板中生成。API 密钥可供所有用户使用，并在设置中进行管理。请记住：即时/无延迟行为仅适用于绑定到活跃付费订阅的密钥。

需要即时 API 访问？订阅计划：

查看订阅套餐

API 速率限制和功能

免费层级有限制，订阅解锁更高性能

我们的 API 需要 API 密钥才能进行所有访问。免费层级对每个请求都有标准处理速度，并适用速率限制。订阅用户获得具有更高限制的即时访问：

免费层级

需要 API 密钥

非优先队列

Eco 计划

€1.99/月

无延迟，20请求/秒

Core 计划

€2.99/月

无延迟，50请求/秒

Elite 计划

€4.99/月

无延迟，无限

Team

€49/月 · 5 个席位 · 每个席位均享 Elite 功能

多席位

记住：免费层级始终可用！

所有访问都需要 API 密钥。免费层级始终以标准处理速度可用。订阅可消除延迟并提高速率限制。

代码示例

不同语言的实现示例

// Public endpoint: Use X-API-KEY
async function getEmails(email, apiKey = null, limit = 25, offset = 0) {
  const headers = apiKey ? { 'X-API-KEY': apiKey } : {};
  const params = new URLSearchParams({ email });
  if (limit !== 25) params.append('limit', limit.toString());
  if (offset > 0) params.append('offset', offset.toString());
  const url = `https://api.cybertemp.xyz/getMail?${params}`;
  const response = await fetch(url, { headers });
  if (!response.ok) { const err = await response.text(); throw new Error('HTTP error! ' + response.status + ': ' + err); }
  return response.json();
}

更喜欢使用客户端库？跳转到客户端库

Webhook

当邮件到达您的任何收件箱时,在您的端点接收 HMAC-SHA256 签名的 POST。

仅限 Elite + Team

Webhook 是 Elite 套餐 (€4.99/月) 的一部分。Team 所有者和成员也可使用。

事件类型

message.received新邮件到达您的某个收件箱。
inbox.created您的账户上配置了新收件箱。
test.ping从仪表板的「测试」按钮触发 — 在真实邮件到达之前验证您的端点很有用。

请求标头

X-Cybertemp-Signature: sha256=<hmac_hex>

X-Cybertemp-Event: message.received

X-Cybertemp-Delivery: <unique_id>

X-Cybertemp-Timestamp: <unix_seconds>

Content-Type: application/json

负载结构

{
  "event": "message.received",
  "delivery_id": "7c4f...",
  "timestamp": 1731234567,
  "data": {
    "inbox_id": "5d2f...",
    "inbox": "[email protected]",
    "message_id": "9a1b...",
    "from": "[email protected]",
    "to": ["[email protected]"],
    "subject": "Your verification code",
    "received_at": "2026-05-17T09:31:00Z",
    "size_bytes": 4732,
    "encrypted": true
  }
}

验证签名

使用您的签名密钥对原始请求正文进行 HMAC,并使用恒定时间比较与 X-Cybertemp-Signature 标头进行比较。

import crypto from "node:crypto";
import express from "express";

const app = express();
app.use("/webhooks/cybertemp",
  express.raw({ type: "application/json" }));

app.post("/webhooks/cybertemp", (req, res) => {
  const header = req.header("x-cybertemp-signature") || "";
  const expected = "sha256=" + crypto
    .createHmac("sha256", process.env.CT_WEBHOOK_SECRET)
    .update(req.body)
    .digest("hex");

  if (!crypto.timingSafeEqual(
    Buffer.from(header), Buffer.from(expected)
  )) return res.status(401).end();

  const event = JSON.parse(req.body.toString("utf8"));
  // ...handle event...
  res.status(200).end();
});

重试策略

在 5xx 或超时时,我们使用指数退避 (1分钟、5分钟、30分钟、6小时) 重试。连续失败 10 次后,我们将自动暂停 webhook 并在仪表板中显示横幅。2xx 视为成功并重置失败计数器。

管理您的 webhook 端点和签名密钥

打开设置 → Webhooks

客户端库

基于同一 REST API 发布的封装库。每个都是轻量客户端：它们能做的，普通 HTTP 请求同样能做。

Python

PyPI

安装

pip install cybertemp

使用

from cybertemp import CyberTemp

client = CyberTemp(api_key="tk_...")
emails = client.get_email_content("[email protected]")
domains = client.get_domains()

GitHub

安装

go get github.com/sexfrance/cybertemp-go

使用

import cybertemp "github.com/sexfrance/cybertemp-go"

c := cybertemp.New("tk_...")
inbox, _ := c.CreateInbox(ctx, nil)
msg, _ := c.WaitForMessage(ctx, inbox.ID, 60*time.Second, nil)

Rust

crates.io

安装

cargo add cybertemp tokio --features tokio/full

使用

use cybertemp::Client;
use std::time::Duration;

let client = Client::new("tk_...");
let inbox = client.create_inbox().await?;
let msg = client.wait_for_message(&inbox.id, Duration::from_secs(60)).await?;

Node / TypeScript

安装

无需安装包：Node 18+ 已内置 fetch。

使用

const res = await fetch(
  "https://api.cybertemp.xyz/[email protected]",
  { headers: { "X-API-KEY": process.env.CYBERTEMP_API_KEY! } },
);
const emails = await res.json(); // [{ id, from, subject, text, html, date }]

套餐限制会返回清晰的错误

触达限制时会返回 HTTP 402（并发收件箱上限）或 429（速率限制）以及 JSON 错误正文，让您的 CI 日志显示具体触达了哪项限制，而不是笼统的失败。

API 端点

GET/getMail

免费（非优先）或优先（需活跃订阅）

一站式邮件 API！这个单一端点可以满足您的所有需求：

getEmails 如何工作：

✓如果收件箱不存在，则自动创建。
✓检索该地址的所有电子邮件。
✓返回完整内容（HTML、文本、主题等）。
✓域名灵活：使用任何域名（例如 @discord.com），我们都能处理。
✓支持大型收件箱的分页功能。

认证：

API 密钥：最快。订阅后可得即时访问。添加头部：

参数 (查询字符串)：

email

必填

目标邮箱地址 (例如 [email protected])。如果是新的会自动创建。

limit

可选

返回的邮件数量 (默认 25，最大 100)。

offset

可选

分页偏移量 (默认 0)。

示例请求：

GET /[email protected]&limit=50&offset=100
X-API-KEY: your_api_key_here

示例响应：

[
  {
    "id": "email:xyz",
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Test Email",
    "text": "Email content",
    "html": "<p>Email content</p>",
    "date": "2024-01-01T00:00:00.000Z"
  }
]

// Public endpoint: Use X-API-KEY async function getEmails(email, apiKey = null, limit = 25, offset = 0) { const headers = apiKey ? { 'X-API-KEY': apiKey } : {}; const params = new URLSearchParams({ email }); if (limit !== 25) params.append('limit', limit.toString()); if (offset > 0) params.append('offset', offset.toString()); const url = `https://api.cybertemp.xyz/getMail?${params}`; const response = await fetch(url, { headers }); if (!response.ok) { const err = await response.text(); throw new Error('HTTP error! ' + response.status + ': ' + err); } return response.json(); }

{ "event": "message.received", "delivery_id": "7c4f...", "timestamp": 1731234567, "data": { "inbox_id": "5d2f...", "inbox": "[email protected]", "message_id": "9a1b...", "from": "[email protected]", "to": ["[email protected]"], "subject": "Your verification code", "received_at": "2026-05-17T09:31:00Z", "size_bytes": 4732, "encrypted": true } }

import crypto from "node:crypto"; import express from "express"; const app = express(); app.use("/webhooks/cybertemp", express.raw({ type: "application/json" })); app.post("/webhooks/cybertemp", (req, res) => { const header = req.header("x-cybertemp-signature") || ""; const expected = "sha256=" + crypto .createHmac("sha256", process.env.CT_WEBHOOK_SECRET) .update(req.body) .digest("hex"); if (!crypto.timingSafeEqual( Buffer.from(header), Buffer.from(expected) )) return res.status(401).end(); const event = JSON.parse(req.body.toString("utf8")); // ...handle event... res.status(200).end(); });

use cybertemp::Client; use std::time::Duration; let client = Client::new("tk_..."); let inbox = client.create_inbox().await?; let msg = client.wait_for_message(&inbox.id, Duration::from_secs(60)).await?;

const res = await fetch( "https://api.cybertemp.xyz/[email protected]", { headers: { "X-API-KEY": process.env.CYBERTEMP_API_KEY! } }, ); const emails = await res.json(); // [{ id, from, subject, text, html, date }]

[ { "id": "email:xyz", "from": "[email protected]", "to": "[email protected]", "subject": "Test Email", "text": "Email content", "html": "<p>Email content</p>", "date": "2024-01-01T00:00:00.000Z" } ]