Documentação API

Quando não se tem a chave, é possível fazer chamadas anônimas para o sistema, e gerar ou ler endereços de e-mail temporários de forma totalmente gratuita. Se você comprou um plano que inclui funcionalidades relacionadas a APIs, pode gerar sua própria chave no centro de membros → Developers’ API Keys. Com essa chave, você poderá utilizar as vantagens oferecidas pelo plano correspondente, como limites de armazenamento e período de retenção de dados.

Forma de transporte (escolha uma das duas opções)

Exemplo de solicitação

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

Uma endereço de e-mail temporário é gerado aleatoriamente. Após a geração do endereço, você pode começar a receber mensagens, sem necessidade de ativação prévia.

Parâmetros da solicitação

Exemplo de solicitação

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

Exemplos de respostas

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

Ative um endereço com um prefixo personalizado (prefixo@domínio), e verifique se o domínio está disponível para recebimento de mensagens.

Parâmetros da solicitação

Exemplo de solicitação

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

Exemplos de respostas

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

Carrega a caixa de entrada da diretoria especificada (os últimos 50 e-mails, organizados em ordem decrescente de data de recebimento). Recomenda-se realizar a consulta a cada 1 a 3 segundos.

Parâmetros da solicitação

Exemplo de solicitação

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

Exemplos de respostas

{
  "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 detalhes da mensagem (remetente, título, conteúdo, lista de anexos). Após visualização, a mensagem será marcada como lida.

Parâmetros da solicitação

Exemplo de solicitação

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

Exemplos de respostas

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

Baixe o anexo do e-mail (arquivo diretamente, não em formato JSON).

Parâmetros da solicitação

Exemplo de solicitação

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

É possível salvar um endereço em sua conta para que seja mantido por tempo prolongado (requer login ou uso de chave API). No entanto, o número de endereços que podem ser salvos está limitado pela quantidade permitida no pacote de serviços relacionados.

Parâmetros da solicitação

Exemplo de solicitação

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

Liste os e-mails salvos na sua conta (é necessário fazer login ou possuir chave de API para acessá-los).

Exemplo de solicitação

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

O seguinte script pode ser executado diretamente na consola do navegador ou no ambiente Node.js: gera um endereço de acesso, realiza a sincronização da caixa de entrada, e imprime o código de verificação assim que a primeira mensagem é recebida.

// 1. Criar um endereço temporário
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('Meu e-mail temporário:', address);

// 2. Polling da caixa de entrada (ocorre a cada 2 segundos; interrompe quando recebe o primeiro e-mail)
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('E-mails novos:', m.subject, code ? 'Código de verificação ' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}