API compatibile · Postal

API compatibile con Postal: cambi indirizzo e chiave

SMTP Senpai accetta le richieste di invio nello stesso formato dell’API di invio di Postal. Punti il codice su SMTP Senpai, usi la chiave msp_ e tieni il tuo SDK, i tuoi campi e la tua gestione degli errori.

Prova gratis 14 giorni

14 giorni gratis · fino a 100 email al giorno · serve la carta · se non disdici entro 14 giorni parte il piano che hai scelto

Stessi percorsi, campi ed errori
Server di invio e registro in Europa
Prova gratis 14 giorni

Node.js · @atech/postal 1.0.0 · cosa cambia

  const Postal = require('@atech/postal');
- const client = new Postal.Client('postal.yourcompany.com', process.env.POSTAL_API_KEY);
+ const client = new Postal.Client('postal-api.mailsenpai.com', process.env.SMTP_SENPAI_KEY); // msp_…

cosa cambia

Cambiano due cose, il resto resta

Stessi percorsi, stessi campi, stesse risposte e stessa forma degli errori dell’API di invio di Postal.

Indirizzo basehttps://app.mailsenpai.com/relay/compat/postal

Oppure l’host dedicatohttps://postal-api.mailsenpai.com

Dove va la chiaveX-Server-API-Key: msp_…

Percorsi (invariati)POST /api/v1/send/message, /api/v1/send/raw

Il mittente deve stare su un dominio verificato nella tua area SMTP Senpai e firmato DKIM: altrimenti la richiesta viene rifiutata con un errore nel formato di Postal.

il codice

Il tuo codice, puntato su SMTP Senpai

Node.js · @atech/postal 1.0.0 · dopo

const Postal = require('@atech/postal');
const client = new Postal.Client('postal-api.mailsenpai.com', process.env.SMTP_SENPAI_KEY); // msp_…

Provato con @atech/postal 1.0.0: provato: collegamento e gestione degli errori.

Altri linguaggi e framework

Impostazioni lette nel codice sorgente di ogni SDK: seguono la stessa regola (indirizzo base o host, più la tua chiave). Provale con un invio di prova prima di andare in produzione.

SDK	Impostazione	Stato
PHP postal/postal	new \Postal\Client('https://postal-api.mailsenpai.com', $key)	Letto nel codice dell’SDK, non ancora provato
Ruby postal-ruby	Postal::Client.new('https://postal-api.mailsenpai.com', key)	Letto nel codice dell’SDK, non ancora provato

campi

Cosa funziona, cosa viene ignorato, cosa viene rifiutato

Funziona

corpi JSON o modulo params=, to, cc, bcc, from, subject, reply_to, plain_body, html_body, headers, attachments; raw con mail_from, rcpt_to, data

Accettato senza effetto

tag, bounce, sender

Indicato nell’intestazione di risposta X-MailSenpai-Ignored.

Rifiutato con l’errore di Postal

—

I client di Postal accettano solo il nome dell’host: usa l’host dedicato. Come in Postal, lo stato HTTP è sempre 200 e l’esito sta in status.

eventi e webhook

Gli esiti delle consegne dall’API di SMTP Senpai

Gli endpoint di Postal per log, eventi, statistiche e webhook non sono riprodotti. Gli esiti (sent, delivered, bounce, defer, complaint, dropped, open, click) arrivano dall’API di SMTP Senpai con la stessa chiave: GET /relay/v1/eventi, oppure un webhook firmato impostato nella tua area SMTP Senpai.

L’id nella risposta all’invio è il message_id di quegli eventi. Ogni risposta porta anche X-MailSenpai-Result (sent, queued, suppressed, failed).

Leggi il riferimento di eventi e webhook

Limiti. Fino a 50 destinatari per messaggio e 500 copie per richiesta (oltre 50 vanno in coda e partono entro circa un minuto), 10 allegati e 10 MB per messaggio. Template e invio programmato non sono supportati: manda il contenuto finale quando vuoi che parta.

Terminale · eventi di SMTP Senpai

curl "https://app.mailsenpai.com/relay/v1/eventi?quanti=50" \
  -H "Authorization: Bearer $SMTP_SENPAI_KEY"

# {"ok": true, "eventi": [{"type": "delivered",
#   "email": "…", "message_id": "…", …}], "prossimo": …}

Domande frequenti

Devo riscrivere il codice che usa Postal?

No. Cambi l’indirizzo base (o l’host) e la chiave. Percorsi, campi, risposte e formato degli errori restano quelli dell’API di invio di Postal, quindi il tuo SDK e la gestione degli errori continuano a funzionare.

E i template e l’invio programmato?

Non sono supportati: le richieste che li usano vengono rifiutate con l’errore nativo, così non parte nulla per sbaglio. Prepara il contenuto finale nel tuo codice e mandalo quando vuoi che parta.

Come ricevo rimbalzi, aperture e webhook?

Dall’API di SMTP Senpai, con la stessa chiave: GET /relay/v1/eventi oppure un webhook firmato impostato nella tua area SMTP Senpai. Gli endpoint di eventi e webhook di Postal non sono riprodotti.

Posso continuare a spedire via SMTP?

Sì. Lo stesso account funziona anche via SMTP (relay.mailsenpai.com, porta 2525, STARTTLS) e con l’API REST di SMTP Senpai.

altre API compatibili

Gli altri formati che SMTP Senpai accetta

Tutte le 14 API compatibili

La tabella con indirizzi base, host dedicati e chiavi.

Apri

API compatibile con SendGrid

API v3 Mail Send di SendGrid

Apri

API compatibile con Mailgun

API Messages di Mailgun

Apri

API compatibile con Amazon SES

API di Amazon SES (v2 SendEmail, v1 SendEmail e SendRawEmail)

Apri

API compatibile con Postmark

API Email di Postmark

Apri

API compatibile con Resend

API Emails di Resend

Apri

Prova SMTP Senpai con il tuo codice di oggi

14 giorni per cambiare indirizzo base e chiave, mandare le tue email vere e controllare ogni esito nel registro. Poi decidi.

Prova gratis 14 giorni

Postal è un software open source (licenza MIT, © Krystal Hosting Ltd e contributori). È citato solo per descrivere il formato di richiesta che SMTP Senpai accetta. MailSenpai non è affiliata al progetto Postal né a Krystal e questa pagina non è approvata da loro. Informazioni verificate il 9 ottobre 2026.

14 giorni gratisProva gratis