Hoppa till innehållet
Verifierad

Skicka ett mejl

Bekräfta att utgående e-post fungerar med ett enda anrop, innan en verklig avisering beror på den.

test_email skickar ett riktigt meddelande genom samma Stalwart-inlämningsväg som varje plattformsmejl använder, utgående från @xuda.ai, med DKIM och SPF i linje. Det finns inget att konfigurera först: anropa den, kontrollera inkorgen (eller felet), så vet du att utgående e-post fungerar innan något annat i din integration beror på den.

Metod

POST/cpi/test_email
admin

Test Email

Runs a test for email.

Två fält till som registret inte listar

test_email deklarerar ett obligatoriskt fält, email. Hanteraren läser också ett valfritt app_id (hämtar det projektets varumärke till mallen; utelämnat betyder plattformens eget Xuda-varumärke) och ett valfritt from (en annan Xuda-brevlåda att skicka som, vars egna inlämningsuppgifter redan måste finnas på serversidan). Båda återges nedan från källkoden, inte från registret.

Genomgång

Skicka

Bara api_key och den adress du vill ta emot testet på.

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'])

Svaret

data är nodemailers eget SMTP-resultatobjekt, vidarebefordrat som det är:

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 betyder att inlämningsservern tog emot meddelandet för leverans, inte att det hamnade i inkorgen, accepted är den adresslista som Stalwart själv bekräftade, och en icke-tom rejected i ett i övrigt code: 1-svar betyder att Stalwart accepterade några mottagare och nekade andra. Det finns ingen leveranswebhook bakom det här anropet: ett code: 1-svar är hela signalen du får från själva test_email.

Fel

Nästa