---
title: "Temp Mail API – API de email temporário | Fake Email"
description: "API de email temporário para testes (temporary email API): caixas descartáveis por REST e códigos OTP no Playwright, Cypress e Selenium. Chave grátis."
canonical_url: "https://fake-email.pro/pt/api"
meta:
  "og:description": "Disposable email API e receive email API: crie caixas de email descartáveis por REST e receba códigos OTP e links de confirmação nos seus testes."
  "og:image": "https://fake-email.pro/_og/s/o_800815a27ca1946c.png"
  "og:image:height": "600"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "Temp Mail API – API de email temporário"
  "twitter:image": "https://fake-email.pro/_og/s/o_800815a27ca1946c.png"
---

> Index of every page on this site: [llms.txt](https://fake-email.pro/llms.txt)

Beta aberto: o PRO é grátis até começarmos a cobrar. Vamos avisar por email 30 dias antes.

# **Temp Mail API**

Crie uma caixa de email descartável com uma requisição, espere o email chegar e receba o código de uso único e o link de confirmação já extraídos. Para testes end-to-end, CI e agentes de IA.

[**Obter uma chave de API**](https://fake-email.pro/pt/login?next=%2Fpt%2Fsettings%2Fapi-keys) [**Início rápido**](https://fake-email.pro/api/docs/getting-started)

Chave de API grátis com qualquer conta · sem cartão

```
      
        import { FakeEmail } from 'fake-email-pro'
        
      
        
        
      
        const client = new FakeEmail() // reads FAKE_EMAIL_API_KEY
        
      
        
        
      
        const mailbox = await client.mailboxes.create()
        
          
            
              ↳
              "anna.smith.42@example.org"
              201 · 142 ms
            
          
        
      
        // sign up with mailbox.address, then:
        
      
        const code = await client.waitForCode(mailbox.address)
        
          
            
              ↳
              "482913"
              200 · 2.4 s
            
          
        

```

Resposta

```
{
  "from": { "name": "Acme", "address": "no-reply@acme.example" },
  "subject": "Your verification code",
  "code": "482913",
  "confirmLink": "https://acme.example/verify?t=3f9a"
}
```

## **Escolha como se conectar**

Uma única chave de API serve para os três. Cada caixa de email conta uma vez na cota mensal, seja qual for o jeito de criá-la.

### **API REST**

Qualquer linguagem que fale HTTP: uma chave Bearer, JSON na entrada e na saída e um documento OpenAPI 3 para gerar um cliente.

`POST /v1/mailboxes`

[Início rápido](https://fake-email.pro/api/docs/getting-started) [Endpoints](https://fake-email.pro/api/docs/reference)

### **SDKs**

Clientes oficiais e tipados para a sua linguagem. waitForCode() espera o email e devolve o código.

[**.NET**](https://fake-email.pro/api/docs/sdks/csharp) [** Go**](https://fake-email.pro/api/docs/sdks/go) [** Java**](https://fake-email.pro/api/docs/sdks/java) [** Node.js**](https://fake-email.pro/api/docs/sdks/javascript) [** PHP**](https://fake-email.pro/api/docs/sdks/php) [** Python**](https://fake-email.pro/api/docs/sdks/python)

[Todos os SDKs](https://fake-email.pro/api/docs/sdks)

### **Servidor MCP**

Claude Code, Cursor, VS Code ou um agente no CI ganha a própria caixa de entrada como ferramentas: ele cria a caixa de email, faz o cadastro e lê o código sozinho.

`https://api.fake-email.pro/mcp`

[Sobre o servidor MCP](https://fake-email.pro/pt/api/mcp) [Configuração](https://fake-email.pro/api/docs/mcp)

## **Feita para a etapa de email de um teste**

<dl>

<dt>**Espere, sem polling**</dt>
<dd>A requisição de espera fica aberta por até 60 segundos e responde assim que o email chega. Não importa quanto tempo espere, ela conta como uma requisição no limite de taxa. <code>GET /v1/mailboxes/{address}/messages/wait</code></dd>

<dt>**Código e link já extraídos**</dt>
<dd>Cada mensagem chega com o código de uso único e o link de confirmação já tirados do corpo, então o seu teste não precisa analisar HTML. <code>"code": "482913", "confirmLink": "https://…"</code></dd>

<dt>**Um endereço novo a cada execução**</dt>
<dd>As caixas de email duram 24 horas, então cada execução começa do zero. Apague a caixa quando o teste terminar e as mensagens vão junto. <code>DELETE /v1/mailboxes/{address}</code></dd>

<dt>**Erros fáceis de tratar**</dt>
<dd>Todo erro é um JSON com um código de erro estável e uma mensagem legível. Um 429 traz Retry-After, para o cliente saber quanto tempo esperar. <code>{ "error": "not_found", "message": "…" }</code></dd>

</dl>

## **Preços da API**

Comece com uma chave no plano grátis Com conta e passe para o PRO quando a sua suíte de testes crescer.

### **Com conta**

**US$ 0**para sempre

Entre com Google e mantenha os seus endereços.

- Caixas de email da API por mês**–**
- Requisições à API por minuto**–**
- Esperas simultâneas na API**–**

[**Começar grátis**](https://fake-email.pro/pt/login?next=%2Fpt%2Fsettings%2Fapi-keys)

### **PRO**

**US$ 4,99**/ mês

Cobrança de US$ 59,88 por ano — você economiza US$ 60

Mais de tudo, e volume na API.

- Requisições à API por minuto**–**
- Esperas simultâneas na API**–**

Caixas de email da API por mês**300**

[**Entre com o Google para experimentar o PRO**](https://fake-email.pro/pt/login?next=%2Fpt%2Fapi)

Beta aberto: o PRO é grátis até começarmos a cobrar. Vamos avisar por email 30 dias antes.

## **Guias**

- [**Teste de email com Playwright, Cypress e Selenium**Passo a passo: crie uma caixa de email por teste, espere o email e digite o código OTP.](https://fake-email.pro/api/docs/email-testing)
- [**Esperando emails**Como funciona a requisição de espera, qual timeout escolher e o que fazer quando nada chega.](https://fake-email.pro/api/docs/waiting-for-emails)
- [**Dê uma caixa de entrada a um agente de IA**Deixe o Claude Code, o Cursor ou um agente no CI fazer o cadastro e ler o email de verificação pelo servidor MCP.](https://fake-email.pro/pt/api/mcp)
- [**Alternativa ao Mailinator**Como o fake-email.pro se compara ao Mailinator em privacidade, retenção, acesso à API e preço.](https://fake-email.pro/mailinator-alternative)

## **Comece a construir**

Pegue uma chave e teste com a API real em poucos minutos.

[**Obter uma chave de API**](https://fake-email.pro/pt/login?next=%2Fpt%2Fsettings%2Fapi-keys) [**Ver a documentação**](https://fake-email.pro/api/docs)

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://fake-email.pro/#identity","@type":"Organization","name":"Fake Email","url":"https://fake-email.pro/","logo":{"@id":"https://fake-email.pro/#logo"},"sameAs":["https://chromewebstore.google.com/detail/ikpficnbjgakkjpcpijcmhodechpmgln"]},{"@id":"https://fake-email.pro/#website","@type":"WebSite","inLanguage":"pt","name":"Fake Email","url":"https://fake-email.pro/","alternateName":["fake-email.pro"],"publisher":{"@id":"https://fake-email.pro/#identity"}},{"@id":"https://fake-email.pro/pt/api#webpage","@type":"WebPage","description":"API de email temporário para testes (temporary email API): caixas descartáveis por REST e códigos OTP no Playwright, Cypress e Selenium. Chave grátis.","name":"Temp Mail API – API de email temporário","url":"https://fake-email.pro/pt/api","about":{"@id":"https://fake-email.pro/#identity"},"isPartOf":{"@id":"https://fake-email.pro/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://fake-email.pro/pt/api"]}],"primaryImageOfPage":{"@id":"https://fake-email.pro/#logo"}},{"@id":"https://fake-email.pro/#logo","@type":"ImageObject","caption":"Fake Email","contentUrl":"https://fake-email.pro/128-icon.png","inLanguage":"pt","url":"https://fake-email.pro/128-icon.png"}]}
```