Documentación de API

URL base:https://api.cybertemp.xyzEl nivel gratuito tiene velocidad de procesamiento estándar; suscríbete para acceso prioritario.

Recuperación de correos

Bandejas temporales

Múltiples dominios

Planes de suscripción

Obtén tu clave API gratuita Ver precios

Cómo usar nuestra API (¡Es fácil!)

¡Nuestra API es flexible! Elige acceso GRATUITO (con un ligero retraso) o SUSCRÍBETE para acceso instantáneo.

API Pública: Acceso a datos generales

Los endpoints como getMail o getDomains tienen dos modos:

Velocidad Estándar: Se requiere clave API, con cola de procesamiento estándar para asegurar un uso justo para todos.
Ultrarrápido (Usuarios suscritos): Usa tu clave API en el encabezado X-API-KEY . Esto te da respuestas instantáneas y límites más altos según tu plan.

X-API-KEY: your_subscription_api_key_here

API Pública: Gratis (Estándar) o Instantáneo (Prioridad)

Úsalo para datos generales de correo. El acceso gratuito se procesa a velocidad estándar. Suscríbete para acceso prioritario instantáneo con límites más altos.

Token Bearer (para endpoint privado)

Usa el encabezado Authorization: Bearer <token> solo para el endpoint privado /private/emails. Genera este token en tu panel. Te autentica como un usuario específico para acceder a tus correos personales vía API.

Authorization: Bearer your_generated_dashboard_token_here

Acceso a endpoint privado

El token Bearer vincula la solicitud API directamente a tu cuenta de usuario, permitiendo acceso a correos asociados con tu dirección privada. Obtén tu token desde el panel.

Cómo obtener una clave API

Las claves API están disponibles para todos los usuarios. Nota: el acceso instantáneo/sin retraso solo se otorga cuando la clave API está vinculada a un plan de suscripción de pago activo; de lo contrario, las solicitudes se tratan como públicas (sujetas a velocidad estándar y límites del nivel gratuito).

Inicia sesión en tu cuenta

Inicia sesión en tu cuenta CyberTemp usando tu correo y contraseña.

Accede a Configuración

Haz clic en tu avatar de perfil en la esquina superior derecha, luego selecciona "Configuración" en el menú desplegable.

Generar clave API

Desplázate hasta la sección "Claves API" y haz clic en el botón "Generar nueva clave". Copia y guarda tu clave API de forma segura.

Ir a Configuración para gestionar claves API

Acceso API: Guía Súper Simple

API Pública (correos generales, dominios): Con X-API-KEY = GRATIS (Cola no prioritaria). Con suscripción activa = PRIORIDAD (Instantáneo).

Endpoint Privado (/private/emails): Usa Authorization: Bearer <token> (requerido).

Los tokens Bearer se generan en el panel. Las claves API están disponibles para todos los usuarios y se gestionan en Configuración. Recuerda: el comportamiento instantáneo solo se aplica a claves vinculadas a suscripciones activas.

¿Necesitas acceso API instantáneo? Suscríbete:

Ver planes de suscripción

Límites y funciones de la API

El nivel gratuito tiene límites, las suscripciones desbloquean mayor rendimiento

Nuestra API requiere una clave API para todo acceso. El nivel gratuito tiene velocidad de procesamiento estándar en cada solicitud y aplican límites. Los usuarios suscritos obtienen acceso instantáneo con límites más altos:

Nivel Gratuito

Clave API requerida

Cola no prioritaria

Plan Eco

€1.99/mes

Sin retraso, 20 req/seg

Plan Core

€2.99/mes

Sin retraso, 50 req/seg

Plan Elite

€4.99/mes

Sin retraso, Ilimitado

Team

€49/mes · 5 plazas · funciones de Elite en cada plaza

Varias plazas

Recuerda: ¡Nivel gratuito siempre disponible!

Se requiere clave API para todo acceso. El nivel gratuito siempre está disponible a velocidad estándar. Las suscripciones eliminan el retraso y aumentan los límites.

Ejemplos de código

Ejemplos de implementación en diferentes lenguajes

// 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();
}

¿Prefieres una biblioteca cliente? Ve a Bibliotecas cliente

Webhooks

Recibe POSTs firmados con HMAC-SHA256 en tu endpoint cada vez que un mensaje llega a una de tus bandejas.

Solo Elite + Team

Los webhooks forman parte del plan Elite (€4.99/mes). Los propietarios y miembros de Team también los tienen.

Tipos de eventos

message.receivedLlega un nuevo email a una de tus bandejas.
inbox.createdSe aprovisiona una nueva bandeja en tu cuenta.
test.pingDisparado desde el botón «Probar» del panel — útil para verificar tu endpoint antes de que lleguen mensajes reales.

Cabeceras de la petición

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

Estructura del payload

{
  "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
  }
}

Verifica la firma

Calcula un HMAC del cuerpo crudo con tu secreto y compáralo con la cabecera X-Cybertemp-Signature usando comparación a tiempo constante.

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();
});

Política de reintentos

Ante 5xx o timeout reintentamos con backoff exponencial (1min, 5min, 30min, 6h). Tras 10 fallos consecutivos pausamos el webhook y mostramos un aviso en el panel. Un 2xx se trata como éxito y reinicia el contador de fallos.

Gestiona tus endpoints y secretos de firma

Abrir Ajustes → Webhooks

Bibliotecas cliente

Wrappers publicados sobre la misma API REST. Cada uno es un cliente ligero: todo lo que hacen también se puede hacer con una simple solicitud HTTP.

Python

PyPI

Instalar

pip install cybertemp

Uso

from cybertemp import CyberTemp

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

GitHub

Instalar

go get github.com/sexfrance/cybertemp-go

Uso

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

Instalar

cargo add cybertemp tokio --features tokio/full

Uso

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

Instalar

No necesitas ningún paquete: Node 18+ incluye fetch.

Uso

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 }]

Los límites del plan devuelven errores claros

Al alcanzar un límite se devuelve HTTP 402 (límite de bandejas simultáneas) o 429 (límite de peticiones) con un cuerpo de error JSON, así que los registros de tu CI muestran qué límite alcanzaste en lugar de un simple fallo.

Endpoints de la API

GET/getMail

Gratis (No Prioritario) o Prioritario (con suscripción activa)

¡API de correo todo en uno! Este único endpoint hace todo lo que necesitas:

Cómo funciona getEmails:

✓Crea automáticamente la bandeja si no existe.
✓Recupera todos los correos para la dirección.
✓Devuelve contenido completo (HTML, Texto, Asunto, etc.).
✓Dominio flexible: Usa cualquier dominio (ej. @discord.com), nosotros lo manejamos.
✓Soporte de paginación para bandejas grandes.

Autenticación:

Clave API: Lo más rápido. Acceso instantáneo si estás suscrito. Añade encabezado:

Parámetros (Query String):

email

obligatorio

Dirección de correo objetivo (ej. [email protected]). Se crea auto si es nueva.

limit

opcional

Número de correos a devolver (defecto 25, máx 100).

offset

opcional

Desplazamiento de paginación (defecto 0).

Ejemplo de solicitud:

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

Ejemplo de respuesta:

[
  {
    "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" } ]