Documentación API

Si no lleva consigo la clave, puede llamar al servicio de forma anónima. Generar o leer correos electrónicos temporales es completamente gratuito. Si ha comprado un paquete que incluye funciones de API, puede generar su propia clave en el centro de membresía → “API para desarrolladores”. Al utilizar esta clave, podrá disfrutar de los beneficios correspondientes del paquete, como los límites de almacenamiento y la duración de las prestaciones ofrecidas.

Forma de transporte (elección entre dos opciones)

Ejemplo de solicitud

curl "https://www.mail0.vip/mail/gen?key=YOUR_API_KEY"

Se genera una dirección de correo electrónico temporal al azar. Una vez generada, puede utilizarla para enviar mensajes sin necesidad de activarla previamente.

Parámetros de solicitud

Ejemplo de solicitud

curl "https://www.mail0.vip/mail/gen?domain=ideciphera.com&ttl=60"

Ejemplos de respuestas

{
  "code": 1,
  "address": "k3j8fh2ma@ideciphera.com"
}

Active una dirección con un prefijo personalizado (prefijo@dominio), y verifique si el dominio está disponible para recibir mensajes.

Parámetros de solicitud

Ejemplo de solicitud

curl -X POST "https://www.mail0.vip/mail/activate" \
  -d "address=mybox@ideciphera.com&ttl=60"

Ejemplos de respuestas

{
  "code": 1,
  "address": "mybox@ideciphera.com"
}

Recuperar la carpeta de correo de la dirección especificada (los 50 mensajes más recientes, ordenados en orden descendente según la fecha de recepción). Se recomienda realizar una consulta cada 1 a 3 segundos.

Parámetros de solicitud

Ejemplo de solicitud

curl "https://www.mail0.vip/mail/inbox?address=mybox@ideciphera.com"

Ejemplos de respuestas

{
  "code": 1,
  "exists": 1,
  "address": "mybox@ideciphera.com",
  "list": [
    {
      "id": 1024,
      "from_addr": "noreply@example.com",
      "from_name": "Example",
      "subject": "Your verification code is 826413",
      "size": 2048,
      "is_read": 0,
      "attachments": 0,
      "received_at": "2026-10-14 18:20:31"
    }
  ]
}

Ver detalles del correo electrónico (remitente, tema, cuerpo del mensaje, lista de archivos adjuntos). Después de verlo, el correo será marcado como leído.

Parámetros de solicitud

Ejemplo de solicitud

curl "https://www.mail0.vip/mail/view?address=mybox@ideciphera.com&id=1024"

Ejemplos de respuestas

{
  "code": 1,
  "data": {
    "id": 1024,
    "from_addr": "noreply@example.com",
    "from_name": "Example",
    "subject": "Your verification code is 826413",
    "body_text": "Dear user, your verification code is 826413, valid for 5 minutes.",
    "received_at_fmt": "2026-10-14 18:20:31",
    "attachments": [
      { "id": 88, "filename": "invoice.pdf", "size": 102400 }
    ]
  }
}

Descargue el archivo adjunto del correo electrónico (se proporciona directamente como flujo de datos, no en formato JSON).

Parámetros de solicitud

Ejemplo de solicitud

curl -O "https://www.mail0.vip/mail/attach?id=88"

Puede guardar una dirección en su cuenta para que se mantenga a largo plazo (es necesario iniciar sesión o llevar consigo la clave de API). La cantidad de direcciones que se pueden guardar está limitada por los límites establecidos en el paquete “Direcciones que se pueden guardar”.

Parámetros de solicitud

Ejemplo de solicitud

curl -X POST "https://www.mail0.vip/mail/save" \
  -d "address=mybox@ideciphera.com&key=YOUR_API_KEY"

Lista los correos electrónicos que se han guardado en tu cuenta (es necesario iniciar sesión o tener la clave de API disponible).

Ejemplo de solicitud

curl "https://www.mail0.vip/mail/my?key=YOUR_API_KEY"

El siguiente script puede ejecutarse directamente en la consola del navegador o en el entorno Node.js: se genera una dirección de correo, se realiza una sincronización con la bandeja de entrada, y cuando se recibe el primer correo electrónico, se imprime el código de verificación.

// 1. Generar una dirección temporal
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('Mi correo electrónico temporal:', address);

// 2. Pollinado de la bandeja de entrada (una vez por cada 2 segundos, se detiene al recibir el primer mensaje)
const seen = new Set();
while (true) {
  const d = await (await fetch(BASE + '/mail/inbox?address=' + encodeURIComponent(address))).json();
  for (const m of d.list || []) {
    if (seen.has(m.id)) continue;
    seen.add(m.id);
    const code = (m.subject || '').match(/\d{4,8}/);
    console.log('Nuevas correos electrónicos:', m.subject, code ? 'Código de verificación ' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}