Saltar al contenido
Verificada

Enviar un correo

Confirma con una sola llamada que el correo saliente está configurado, antes de que una notificación real dependa de él.

test_email envía un mensaje real por la misma vía de envío de Stalwart que usan todos los correos de la plataforma, saliente de @xuda.ai, con DKIM y SPF alineados. No hay nada que configurar antes: llámala, revisa la bandeja de entrada (o el error) y sabrás que el correo saliente funciona antes de que cualquier otra parte de tu integración dependa de él.

Método

POST/cpi/test_email
admin

Test Email

Runs a test for email.

Dos campos más que el registro no enumera

test_email declara un campo obligatorio, email. El manejador también lee un app_id opcional (incorpora a la plantilla la marca de ese proyecto; si se omite, se usa la propia marca de Xuda de la plataforma) y un from opcional (otro buzón de Xuda desde el que enviar, cuya credencial de envío tiene que existir ya en el servidor). Ambos se reproducen abajo a partir del código fuente, no del registro.

Paso a paso

Envíalo

Solo api_key y la dirección en la que quieres recibir la prueba.

curl -s https://xuda.ai/cpi/test_email \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","email":"[email protected]"}'
const res = await fetch('https://xuda.ai/cpi/test_email', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', email: '[email protected]' }),
});
const { code, data } = await res.json();
if (code > 0) console.log('sent:', data.messageId, data.accepted);
else console.log('failed:', data);
import requests

res = requests.post(
    'https://xuda.ai/cpi/test_email',
    json={'api_key': 'YOUR_API_KEY', 'email': '[email protected]'},
)
body = res.json()
if body['code'] > 0:
    print('sent:', body['data']['messageId'], body['data']['accepted'])
else:
    print('failed:', body['data'])

La respuesta

data es el propio objeto de resultado SMTP de nodemailer, pasado tal cual:

json
{
  "code": 1,
  "data": {
    "accepted": ["[email protected]"],
    "rejected": [],
    "envelopeTime": 210,
    "messageTime": 340,
    "messageSize": 812,
    "response": "250 2.0.0 OK",
    "envelope": { "from": "[email protected]", "to": ["[email protected]"] },
    "messageId": "<[email protected]>"
  }
}

code: 1 significa que el servidor de envío aceptó el mensaje para entregarlo, no que haya llegado a la bandeja de entrada; accepted es la lista de direcciones que confirmó el propio Stalwart, y un rejected no vacío en una respuesta que por lo demás es code: 1 significa que Stalwart aceptó a unos destinatarios y rechazó a otros. No hay ningún webhook de entrega detrás de esta llamada: una respuesta code: 1 es toda la señal que obtienes de test_email en sí.

Errores

Siguiente