Μετάβαση στο περιεχόμενο
Επαληθεύτηκε

Αποστολή email

Επιβεβαιώστε με μία κλήση ότι η εξερχόμενη αλληλογραφία έχει ρυθμιστεί, πριν εξαρτηθεί από αυτήν μια πραγματική ειδοποίηση.

Το test_email στέλνει ένα πραγματικό μήνυμα μέσω της ίδιας διαδρομής υποβολής Stalwart που χρησιμοποιεί κάθε email της πλατφόρμας, εξερχόμενο από το @xuda.ai, με ευθυγραμμισμένα DKIM και SPF. Δεν χρειάζεται να ρυθμίσετε τίποτα πρώτα: καλέστε το, ελέγξτε τα εισερχόμενα (ή το σφάλμα), και ξέρετε ότι η εξερχόμενη αλληλογραφία λειτουργεί πριν εξαρτηθεί από αυτήν οτιδήποτε άλλο στην ενσωμάτωσή σας.

Μέθοδος

POST/cpi/test_email
admin

Test Email

Runs a test for email.

Δύο ακόμη πεδία που το μητρώο δεν αναφέρει

Το test_email δηλώνει ένα υποχρεωτικό πεδίο, το email. Ο χειριστής διαβάζει επίσης ένα προαιρετικό app_id (φέρνει το branding του συγκεκριμένου έργου στο πρότυπο: αν παραλειφθεί, χρησιμοποιείται το δικό του branding Xuda της πλατφόρμας) και ένα προαιρετικό from (ένα άλλο γραμματοκιβώτιο Xuda από το οποίο θα σταλεί, το δικό του διαπιστευτήριο υποβολής πρέπει να υπάρχει ήδη στον διακομιστή). Και τα δύο αναπαράγονται παρακάτω από τον πηγαίο κώδικα, όχι από το μητρώο.

Οδηγός βήμα προς βήμα

Στείλτε το

Απλώς το api_key και η διεύθυνση στην οποία θέλετε να λάβετε το τεστ.

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

Η απάντηση

Το data είναι το δικό του αντικείμενο αποτελέσματος SMTP του nodemailer, που περνά ως έχει:

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 σημαίνει ότι ο διακομιστής υποβολής αποδέχτηκε το μήνυμα για παράδοση, όχι ότι έφτασε στα εισερχόμενα: το accepted είναι η λίστα διευθύνσεων που επιβεβαίωσε το ίδιο το Stalwart, και ένα μη κενό rejected σε μια κατά τα άλλα απάντηση code: 1 σημαίνει ότι το Stalwart αποδέχτηκε κάποιους παραλήπτες και αρνήθηκε άλλους. Δεν υπάρχει webhook παράδοσης πίσω από αυτή την κλήση: μια απάντηση code: 1 είναι όλο το σήμα που παίρνετε από το ίδιο το test_email.

Σφάλματα

Επόμενο