Necesitas direcciones desechables al estilo Gmail que puedas generar bajo demanda, alimentar en pruebas, flujos de registro o scripts de QA, y lo necesitas esta semana. Al final de este artículo podrás generar una sola dirección temporal de Gmail, generar en masa hasta 500 direcciones únicas con reglas de punto/plus, y verificar la actividad de la bandeja de entrada para una dirección dada, utilizando una clave API de Zyla API Hub.
Qué hace esta API y cuándo usarla
La API de GMail Temporal proporciona generación programática de direcciones temporales compatibles con Gmail y una forma de inspeccionar la actividad reciente de la bandeja de entrada para verificaciones. Los casos de uso típicos incluyen:
- Pruebas de extremo a extremo que requieren direcciones únicas con formato de Gmail en cada ejecución.
- Sembrar entornos de demostración con correos electrónicos realistas y entregables.
- Crear flujos de registro paralelos que ejerciten comportamientos de direcciones con punto y plus.
- Consultar actividad reciente para pasos de verificación en staging.
La API se ejecuta en Zyla API Hub, por lo que usas una sola clave API, encabezados de autorización consistentes y un modelo de suscripción + cuota en todo el mercado.
Comenzando en Zyla API Hub
Abre la página de la API de GMail Temporal en Zyla, suscríbete y obtén tu clave. La autenticación es un token portador estándar.
- Ve a la lista del mercado: Inicia prueba de 7 días en la API de GMail Temporal.
- Haz clic en Suscribirse (o Iniciar Prueba Gratuita cuando esté disponible) para obtener tu clave.
- Envía solicitudes con: Authorization: Bearer YOUR_API_KEY.
Zyla utiliza suscripción + cuota (no pago por llamada). Consulta la página de la API para opciones de acceso y precios actuales. Tu clave funciona en más de 10,000 APIs públicas en Zyla API Hub.
Puntos finales que usarás
Todos los puntos finales a continuación son HTTP GET en las URL del hub de Zyla y requieren el encabezado de autorización. Solo se deben enviar los parámetros documentados.
1) Generar Gmail
Genera una sola dirección temporal de Gmail.
- Método: GET
- URL: https://zylalabs.com/api/8382/temporary-gmail-api/14645/generate-gmail
- Parámetros requeridos:
- domain (string): random
cURL (listo para copiar y pegar):
curl -s -X GET "https://zylalabs.com/api/8382/temporary-gmail-api/14645/generate-gmail?domain=random" \
-H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta JSON:
{
"email": "[email protected]"
}
Campos que realmente usarás:
- email: la dirección generada al estilo Gmail que puedes usar inmediatamente en flujos de registro o pruebas.
2) GMail en masa
Genera hasta 500 correos electrónicos temporales únicos con filtros opcionales de punto/plus/dominio.
- Método: GET
- URL: https://zylalabs.com/api/8382/temporary-gmail-api/14647/bulk-gmail
- Parámetros:
- dot (string, opcional): true
- plus (string, requerido): false
cURL:
Ejemplo de respuesta JSON:
Notas:
- count: número de correos electrónicos devueltos en este lote.
- emails: arreglo de variantes únicas de Gmail/Googlemail. Se pueden aplicar puntos y, dependiendo de tus parámetros, direcciones plus.
3) Bandeja de entrada
Recupera la actividad reciente para una dirección especificada, incluyendo cuándo fue consultada, el tiempo de respuesta, cuántos resultados se encontraron y cualquier mensaje disponible para verificación.
- Método: GET
- URL: https://zylalabs.com/api/8382/temporary-gmail-api/14648/inbox
- Parámetros:
- email (string, requerido): [email protected]
cURL:
Ejemplo de respuesta JSON:
Notas:
- email: la dirección a la que pertenece esta actividad.
- queried_at: cadena de tiempo para cuándo se consultó la bandeja de entrada (la zona horaria no está especificada por la API).
- response_time: cadena de duración para el tiempo de procesamiento de la API.
- count: número de mensajes disponibles en este resultado.
- messages: arreglo de mensajes; vacío en esta muestra.
Inicio rápido: genera un Gmail desechable y úsalo en pruebas
Para el camino más rápido, llama a Generar Gmail, guarda el correo electrónico en tu contexto de prueba y luego ejecuta tu flujo.
Ejemplo en Python (requests)
Este ejemplo accede al punto final Generar Gmail, extrae el valor del correo electrónico y lo imprime para su uso en pasos posteriores.
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 temporal generado: {email}")
# Ejemplo: pasa esto a tu carga útil de registro o corredor de pruebas
# signup(user_email=email)
La forma esperada de la respuesta es el ejemplo oficial anterior; verifica data["email"] y conecta esa dirección a tu automatización.
Notas de implementación práctica
- Auth: Siempre envía Authorization: Bearer YOUR_API_KEY.
- Timeouts: Establece un tiempo de espera del cliente (por ejemplo, 30s) para mantener las ejecuciones de prueba predecibles.
- Idempotencia: Los puntos finales de generación crean nuevas variantes en cada llamada; persiste las direcciones elegidas si necesitas ejecuciones repetibles.
- Semántica de punto y plus: El punto final de GMail en masa permite el control de punto y plus a través de sus parámetros documentados. Usa dot=true para obtener variantes con puntos y plus=false según el ejemplo para evitar direcciones plus.
- Marcas de tiempo de bandeja de entrada: queried_at se devuelve como una cadena; la API no especifica zona horaria. Almacénalo tal como está o anota con la hora de tu sistema para auditoría.
- Cacheo y paginación: No especificado para estos puntos finales. Si estás construyendo un sondeador para la bandeja de entrada, implementa retrocesos y evita llamadas repetidas innecesarias.
- Cuotas: Zyla utiliza suscripción + cuota. Monitorea tu volumen de llamadas y consulta la lista del mercado para límites y opciones de acceso actuales.
Recetas de flujo de trabajo
1) Pruebas de registro únicas
- Llama a Generar Gmail con domain=random.
- Usa el correo electrónico devuelto en tu formulario de registro.
- Opcionalmente, consulta la bandeja de entrada para verificar que un mensaje se volvió disponible, si tu flujo de trabajo depende de verificaciones de recibo.
2) Pruebas de carga de registros con direcciones diversas
- Llama a GMail en masa con dot=true&plus=false para obtener un lote de variantes.
- Distribuye las direcciones entre tus trabajadores para evitar colisiones.
- Registra qué dirección corresponde a qué caso de prueba para reproducibilidad.
3) Verificación de correo electrónico QA en staging
- Proporciona una dirección única por ejecución (Generar Gmail).
- Activa tu sistema para enviar un mensaje de verificación.
- Llama a la bandeja de entrada para esa dirección y almacena queried_at, response_time y cualquier mensaje que necesites para validación.
Llamando a la API desde agentes de IA a través de MCP
Si orquestas flujos en un cliente compatible con MCP (por ejemplo, Claude Code, Cursor, Windsurf), puedes llamar a las APIs de Zyla a través de la puerta de enlace MCP. Usa el punto final:
Proporciona tu clave en la cadena de consulta como apikey=YOUR_API_KEY al configurar la URL de la herramienta MCP (por ejemplo, https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY). Luego invoca las acciones de la API de GMail Temporal desde tu agente. La configuración exacta de la herramienta depende de tu cliente; consulta la documentación de tu cliente MCP y mantén el mismo modelo de autorización y parámetros mostrados anteriormente cuando la herramienta reenvíe la llamada.
Consejos para solucionar problemas
- 401 o 403: Confirma que estás enviando Authorization: Bearer YOUR_API_KEY y que la clave está activa en la lista.
- Bandeja de entrada vacía: Es válido que los mensajes estén ausentes; verifica que tu sistema upstream realmente envió el correo electrónico y considera reintentar/retrasar antes de concluir un fallo.
- Conteo inesperado en GMail en masa: La API devuelve hasta 500; el conteo exacto puede variar. Lee el campo count e itera sobre los correos electrónicos en consecuencia.
- Codificación de direcciones plus: Al pasar el correo electrónico al punto final de la bandeja de entrada, codifica en URL caracteres como + y @ como se muestra en la muestra.
Solicitudes listas para copiar
Generar un Gmail
Variantes de Gmail en masa (puntos activados, plus desactivado)
Verificar actividad de bandeja de entrada para una dirección específica
FAQ
¿Qué encabezado de autenticación necesito?
Envía Authorization: Bearer YOUR_API_KEY en cada solicitud.
¿Cuántos correos electrónicos puedo obtener a la vez?
Usa el punto final de GMail en masa para generar hasta 500 correos electrónicos únicos en una sola llamada, sujeto a tu cuota de suscripción.
¿El punto final de la bandeja de entrada devuelve el contenido completo del mensaje?
El punto final de la bandeja de entrada devuelve campos de actividad reciente y mensajes disponibles para verificación. Los campos exactos que verás más allá de la muestra no están documentados aquí; procesa el arreglo de mensajes si está presente.
¿Se admiten puntos y direcciones plus?
GMail en masa admite reglas de punto y plus a través de los parámetros dot y plus. Usa dot=true y plus=false como se muestra para controlar las variantes.
¿Hay un plan gratuito?
Zyla utiliza un modelo de suscripción + cuota. Consulta la lista del mercado para opciones de acceso y precios actuales, incluyendo la prueba disponible.
¿Listo para integrar esto en tu pipeline? Crea tu clave API y envía tu integración hoy: Inicia prueba de 7 días en la API de GMail Temporal. Explora miles de servicios listos para usar en Zyla API Hub, todos con una sola clave.