Προγραμματιστές → Email
Διαχειριστείτε την αλληλογραφία των domains σας από κώδικα: γραμματοκιβώτια σε επί πληρωμή φιλοξενία email, δωρεάν προώθηση για domains καταχωρισμένα στη NameOcean και εισερχόμενα μηνύματα που αποστέλλονται στην εφαρμογή σας ως JSON.
Δημιουργήστε ένα κλειδί API με email:read και email:write για να κάνετε αλλαγές. Όλα τα endpoints βρίσκονται στην τεκμηρίωση του API και στο αρχείο OpenAPI. Η αγορά, η αναβάθμιση και η ανανέωση ενός πακέτου αλληλογραφίας χρεώνονται στο υπόλοιπο του λογαριασμού και γίνονται από τον πίνακα ελέγχου.
Το πακέτο ενός τομέα αλληλογραφίας έχει έναν αποθηκευτικό χώρο που μοιράζονται τα γραμματοκιβώτιά του. Αν δημιουργήσετε ένα γραμματοκιβώτιο χωρίς κωδικό πρόσβασης, δημιουργείται αυτόματα ένας· η απάντηση είναι η μόνη φορά που το API τον επιστρέφει.
$ curl -X POST https://nameocean.net/api/v1/email/domains/example.com/mailboxes \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \ -d '{"username": "info", "full_name": "Info", "quota_gb": 2}' {"address": "info@example.com", "username": "info", "full_name": "Info", "quota_gb": 2, "used_gb": "0.00", "aliases": [], "password": "Qm7…"}
| GET /email/domains/{domain} | Γραμματοκιβώτια, ψευδώνυμα, λίστες και ρυθμίσεις IMAP/SMTP |
| PATCH /email/domains/{domain}/mailboxes/{username} | Αλλαγή ονόματος ή ορίου χώρου |
| POST /email/domains/{domain}/mailboxes/{username}/password | Ορισμός ή δημιουργία κωδικού πρόσβασης |
| POST /email/domains/{domain}/aliases | Παράδοση άλλης διεύθυνσης σε γραμματοκιβώτιο |
| POST /email/domains/{domain}/lists | Λίστα αλληλογραφίας με τα γραμματοκιβώτια του τομέα |
| GET /email/domains/{domain}/dns-check | NS, MX, SPF, DKIM και DMARC, σε πραγματικό χρόνο, με τις αναμενόμενες τιμές |
Τα domains που είναι καταχωρισμένα στη NameOcean και χρησιμοποιούν τους nameservers μας μπορούν να προωθούν την αλληλογραφία τους δωρεάν. Η ενεργοποίηση γράφει την εγγραφή MX· αν η ζώνη έχει εγγραφές MX άλλου παρόχου, στείλτε replace_mx: true για να αφαιρεθούν.
$ curl -X POST https://nameocean.net/api/v1/email/forwarding/example.com \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" $ curl -X POST https://nameocean.net/api/v1/email/forwarding/example.com/aliases \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \ -d '{"localpart": "hello", "to": "me@gmail.com"}'
Μια νέα διεύθυνση προορισμού λαμβάνει ένα μήνυμα με σύνδεσμο και 6ψήφιο κωδικό, και η αλληλογραφία προωθείται μόλις ο κάτοχός της επιβεβαιώσει (μέσω του συνδέσμου ή με POST /email/forwarding/targets/{id}/verify και τον κωδικό). Το * προωθεί κάθε διεύθυνση που δεν έχει δικό της ψευδώνυμο. Το GET /email/forwarding/{domain}/messages εμφανίζει την αλληλογραφία των τελευταίων 30 ημερών με την κατάστασή της· τα μηνύματα σε αναμονή (spam, πάνω από το ημερήσιο όριο) μπορούν να προωθηθούν με /release.
Αντί για προώθηση, μια διεύθυνση μπορεί να αποστέλλει κάθε μήνυμα που λαμβάνει στο HTTPS endpoint σας ως JSON: κείμενο, κεφαλίδες και συνημμένα σε base64. Διατίθεται μετά από σύντομο έλεγχο της χρήσης που σκοπεύετε να κάνετε· ζητήστε το από τη σελίδα Προώθησης Email ενός domain.
$ curl -X POST https://nameocean.net/api/v1/email/forwarding/example.com/webhooks \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \ -d '{"localpart": "inbound", "url": "https://example.com/hooks/mail"}'
X-NameOcean-Event: email.received
X-NameOcean-Signature: t=1794300000,v1=5f2b…
{
"id": "6f1c2a4e-8b3d-4f5a-9c7e-1d2b3a4c5e6f",
"event": "email.received",
"envelope": {"from": "alice@example.org", "to": "inbound@example.com"},
"from": "Alice <alice@example.org>",
"subject": "Order 1042",
"text": "Hi…",
"html": "<p>Hi…</p>",
"headers": [["From", "Alice <alice@example.org>"], …],
"attachments": [{"filename": "invoice.pdf", "content_type": "application/pdf", "size": 48211,
"content_base64": "JVBERi0…"}],
"spam_score": 0.4,
"size": 66120
}
Η υπογραφή λειτουργεί όπως στα webhooks του λογαριασμού: δείτε την επαλήθευση υπογραφής.
Τα webhooks του λογαριασμού μπορούν να εγγραφούν στα email.*: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled και email.forwarding.disabled (αποστέλλεται επίσης όταν ένα domain παύει να πληροί τις προϋποθέσεις για δωρεάν προώθηση, μαζί με την αιτία).
$ nameocean email mailboxes add example.com info --name "Info" $ nameocean email aliases add example.com sales info $ nameocean email check example.com $ nameocean email forwards on example.com $ nameocean email forwards add example.com hello me@gmail.com $ nameocean email inbound add example.com support https://example.com/hooks/mail
Κάθε εντολή δέχεται --json. Εγκατάσταση και όλες οι εντολές: CLI.
Μέσω MCP ένας βοηθός μπορεί να εμφανίσει τα domain αλληλογραφίας σας, να ελέγξει το DNS τους, να δημιουργήσει θυρίδες και ψευδώνυμα και να ενεργοποιήσει την προώθηση. Οι κωδικοί πρόσβασης των θυρίδων δεν αποστέλλονται ποτέ στην τεχνητή νοημοσύνη: τους βλέπετε στον πίνακα ελέγχου.