Oltre al servizio SMTP autenticato, SoloPosta mette a disposizione un’API HTTPS pensata per chi vuole inviare email direttamente dal proprio sito, gestionale o applicazione, senza configurare un client SMTP lato server. È la soluzione più comoda quando l’invio deve partire da un ambiente che parla più naturalmente HTTP che SMTP — un sito che deve inviare newsletter e offerte agli iscritti, un gestionale che deve notificare comunicazioni periodiche, un’applicazione che deve inviare una singola email generata al volo.
L’integrazione è deliberatamente minimale: un solo endpoint, POST /api/send, e una singola chiamata per ogni email da spedire. Ci si autentica con una API key personale, assegnata da SoloPosta all’attivazione del servizio, passata nell’header Authorization con schema Bearer. Il corpo della richiesta, in JSON, accetta mittente, uno o più destinatari, oggetto, corpo del messaggio in testo semplice o HTML, ed eventuali allegati o immagini incorporate codificati in Base64, fino a un totale di 20 MB per richiesta.
curl -X POST https://api.soloposta.biz/api/send \
-H "Authorization: Bearer la-vostra-chiave" \
-H "Content-Type: application/json" \
-d '{
"From": "ordini@ilvostrosito.it",
"To": "cliente@example.com",
"Subject": "Conferma ordine #4521",
"Body": "Il tuo ordine è confermato.",
"IsBodyHtml": false
}'Ogni email inviata tramite API viene firmata con DKIM esattamente come quelle inviate via SMTP e rientra nello stesso conteggio di traffico del vostro piano: nessuna doppia fatturazione, nessuna configurazione aggiuntiva. Una risposta 200 conferma che il messaggio è stato accettato per l’invio (la consegna effettiva avviene in modo asincrono); i casi di errore più comuni — chiave mancante o non valida, account sospeso, richiesta malformata — restituiscono rispettivamente 401, 403 e 400, sempre con un corpo che ne spiega il motivo dove previsto.
L’API è pensata per l’invio transazionale: un messaggio per chiamata, senza code, template o tracking integrati. Per campagne, newsletter e invii massivi resta lo SMTP autenticato descritto nelle altre pagine di questo sito, utilizzabile in parallelo con le stesse credenziali del vostro account.
La documentazione tecnica completa — tutti i campi supportati, i codici di risposta, esempi in PHP e Node.js oltre a curl — è disponibile su api.soloposta.biz.