Você precisa de endereços estilo Gmail descartáveis que você pode gerar sob demanda, usar em testes, fluxos de inscrição ou scripts de QA, e você precisa disso esta semana. Ao final deste artigo, você será capaz de gerar um único endereço temporário do Gmail, gerar em massa até 500 endereços únicos com regras de ponto/mais e verificar a atividade da caixa de entrada para um endereço específico—usando uma chave de API do Zyla API Hub.
O que esta API faz e quando usá-la
A API Temporária do GMail fornece a geração programática de endereços temporários compatíveis com o Gmail e uma maneira de inspecionar a atividade recente da caixa de entrada para verificações de validação. Casos de uso típicos incluem:
- Testes de ponta a ponta que requerem endereços formatados no Gmail únicos em cada execução.
- Preencher ambientes de demonstração com e-mails realistas e entregáveis.
- Criar fluxos de inscrição paralelos que exercitam comportamentos de endereços com ponto e mais.
- Consultar atividade recente para etapas de verificação em staging.
A API funciona no Zyla API Hub, então você usa uma única chave de API, cabeçalhos de autorização consistentes e um modelo de assinatura + cota em todo o mercado.
Começando no Zyla API Hub
Abra a página da API Temporária do GMail no Zyla, inscreva-se e obtenha sua chave. A autenticação é um token bearer padrão.
- Vá para a listagem do marketplace: Iniciar teste de 7 dias na API Temporária do GMail.
- Clique em Inscrever-se (ou Iniciar Teste Gratuito quando disponível) para obter sua chave.
- Envie solicitações com: Authorization: Bearer YOUR_API_KEY.
A Zyla usa assinatura + cota (não pagamento por chamada). Verifique a página da API para opções de acesso e preços atuais. Sua chave funciona em mais de 10.000 APIs públicas no Zyla API Hub.
Endpoints que você usará
Todos os endpoints abaixo são HTTP GETs nas URLs do hub da Zyla e requerem o cabeçalho de autorização. Apenas os parâmetros documentados devem ser enviados.
1) Gerar Gmail
Gera um único endereço temporário do Gmail.
- Método: GET
- URL: https://zylalabs.com/api/8382/temporary-gmail-api/14645/generate-gmail
- Parâmetros necessários:
- domain (string): random
cURL (pronto para copiar e colar):
curl -s -X GET "https://zylalabs.com/api/8382/temporary-gmail-api/14645/generate-gmail?domain=random" \
-H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta JSON:
{
"email": "[email protected]"
}
Campos que você realmente usará:
- email: o endereço gerado no estilo Gmail que você pode imediatamente usar em fluxos de inscrição ou testes.
2) Bulk GMail
Gera até 500 e-mails temporários únicos com filtros de ponto/mais/domínio opcionais.
- Método: GET
- URL: https://zylalabs.com/api/8382/temporary-gmail-api/14647/bulk-gmail
- Parâmetros:
- dot (string, opcional): true
- plus (string, obrigatório): false
cURL:
Exemplo de resposta JSON:
Notas:
- count: número de e-mails retornados neste lote.
- emails: array de variantes únicas do Gmail/Googlemail. Pontos e, dependendo dos seus parâmetros, endereçamento com mais podem ser aplicados.
3) Inbox
Recupera a atividade recente para um endereço especificado, incluindo quando foi consultado, tempo de resposta, quantos resultados foram encontrados e quaisquer mensagens disponíveis para verificação.
- Método: GET
- URL: https://zylalabs.com/api/8382/temporary-gmail-api/14648/inbox
- Parâmetros:
- email (string, obrigatório): [email protected]
cURL:
Exemplo de resposta JSON:
Notas:
- email: o endereço ao qual esta atividade pertence.
- queried_at: string de timestamp para quando a caixa de entrada foi verificada (fuso horário não especificado pela API).
- response_time: string de duração para o tempo de processamento da API.
- count: número de mensagens disponíveis neste resultado.
- messages: array de mensagens; vazio neste exemplo.
Início rápido: gere um Gmail descartável e use-o em testes
Para o caminho mais rápido, chame Gerar Gmail, armazene o e-mail no seu contexto de teste e, em seguida, execute seu fluxo.
Exemplo em Python (requests)
Este exemplo acessa o endpoint Gerar Gmail, extrai o valor do e-mail e o imprime para uso em etapas subsequentes.
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/8382/temporary-gmail-api/14645/generate-gmail"
params = {"domain": "random"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
email = data.get("email")
print(f"Gmail temporário gerado: {email}")
# Exemplo: passe isso para sua carga de inscrição ou executor de teste
# signup(user_email=email)
A forma esperada da resposta é o exemplo oficial acima; verifique data["email"] e conecte esse endereço à sua automação.
Notas de implementação prática
- Auth: Sempre envie Authorization: Bearer YOUR_API_KEY.
- Timeouts: Defina um tempo limite do cliente (por exemplo, 30s) para manter as execuções de teste previsíveis.
- Idempotência: Os endpoints de geração criam novas variantes a cada chamada; persista os endereços escolhidos se você precisar de execuções repetíveis.
- Semântica de ponto e mais: O endpoint Bulk GMail permite controle de ponto e mais através de seus parâmetros documentados. Use dot=true para obter variantes pontuadas e plus=false conforme o exemplo para evitar endereçamento com mais.
- Timestamp da caixa de entrada: queried_at é retornado como uma string; nenhum fuso horário é especificado pela API. Armazene-o como está ou anote com o horário do seu sistema para auditoria.
- Cache e paginação: Não especificado para esses endpoints. Se você estiver construindo um poller para a Caixa de Entrada, implemente backoff e evite chamadas repetidas desnecessárias.
- Quotas: A Zyla usa assinatura + cota. Monitore seu volume de chamadas e verifique a listagem do marketplace para limites e opções de acesso atuais.
Receitas de fluxo de trabalho
1) Teste de inscrição único
- Chame Gerar Gmail com domain=random.
- Use o e-mail retornado em seu formulário de inscrição.
- Opcionalmente, consulte a Caixa de Entrada para verificar se uma mensagem se tornou disponível, se seu fluxo de trabalho depender de verificações de recebimento.
2) Testes de carga de inscrições com endereços diversos
- Chame Bulk GMail com dot=true&plus=false para buscar um lote de variantes.
- Distribua os endereços entre seus trabalhadores para evitar colisões.
- Registre qual endereço mapeia para qual caso de teste para reprodutibilidade.
3) Verificação de e-mail QA em staging
- Provisione um endereço único por execução (Gerar Gmail).
- Acione seu sistema para enviar uma mensagem de verificação.
- Chame a Caixa de Entrada para esse endereço e armazene queried_at, response_time e quaisquer mensagens que você precisar para validação.
Chamando a API de agentes de IA via MCP
Se você orquestra fluxos em um cliente compatível com MCP (por exemplo, Claude Code, Cursor, Windsurf), pode chamar as APIs da Zyla através do gateway MCP. Use o endpoint:
Forneça sua chave na string de consulta como apikey=YOUR_API_KEY ao configurar a URL da ferramenta MCP (por exemplo, https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY). Em seguida, invoque as ações da API Temporária do GMail a partir do seu agente. A configuração exata da ferramenta depende do seu cliente; consulte a documentação do seu cliente MCP e mantenha o mesmo modelo de autorização e parâmetros mostrados acima quando a ferramenta encaminhar a chamada.
Dicas de solução de problemas
- 401 ou 403: Confirme que você está enviando Authorization: Bearer YOUR_API_KEY e que a chave está ativa na listagem.
- Caixa de Entrada vazia: É válido que mensagens estejam ausentes; verifique se seu sistema upstream realmente enviou e-mail e considere tentar novamente/backoff antes de concluir a falha.
- Contagem inesperada no Bulk GMail: A API retorna até 500; a contagem exata pode variar. Leia o campo count e itere sobre os e-mails de acordo.
- Codificação de endereços com mais: Ao passar o e-mail para o endpoint da Caixa de Entrada, codifique em URL caracteres como + e @ conforme mostrado no exemplo.
Solicitações prontas para copiar
Gerar um Gmail
Variantes de Gmail em massa (pontos ativados, mais desativados)
Verificar a atividade da caixa de entrada para um endereço específico
FAQ
Qual cabeçalho de autenticação eu preciso?
Envie Authorization: Bearer YOUR_API_KEY em cada solicitação.
Quantos e-mails posso obter de uma vez?
Use o endpoint Bulk GMail para gerar até 500 e-mails únicos em uma única chamada, sujeito à sua cota de assinatura.
O endpoint da Caixa de Entrada retorna o conteúdo completo das mensagens?
O endpoint da Caixa de Entrada retorna campos de atividade recente e mensagens disponíveis para verificação. Os campos exatos que você verá além do exemplo não estão documentados aqui; processe o array de mensagens se presente.
Os endereços com pontos e mais são suportados?
O Bulk GMail suporta regras de ponto e mais através dos parâmetros dot e plus. Use dot=true e plus=false conforme mostrado para controlar variantes.
Há um plano gratuito?
A Zyla usa um modelo de assinatura + cota. Verifique a listagem do marketplace para opções de acesso e preços atuais, incluindo o teste disponível.
Pronto para integrar isso ao seu pipeline? Crie sua chave de API e implemente sua integração hoje: Iniciar teste de 7 dias na API Temporária do GMail. Explore milhares de outros serviços prontos para uso no Zyla API Hub, todos com uma única chave.