Se volete inviare email direttamente dal vostro sito, gestionale o applicazione senza configurare un client SMTP lato server, SoloPosta mette a disposizione un’API HTTPS. Per chi deve inviare email da gestionale, l’API è comoda quando l’ambiente parla più naturalmente HTTP che SMTP, come un gestionale che notifica comunicazioni periodiche o un’applicazione che spedisce una singola email generata al volo. L’API è pensata per l’invio transazionale e non integra code, template o tracking.
L’integrazione si basa su un solo endpoint, POST /api/send, con una singola chiamata per ogni email da spedire. Vi autenticate con una API key personale, che SoloPosta assegna all’attivazione del servizio e che va passata nell’header Authorization con schema Bearer. Nel corpo JSON della richiesta indicate mittente, uno o più destinatari, oggetto e corpo del messaggio in testo semplice o HTML. Potete aggiungere allegati o immagini incorporate codificati in Base64, fino a 20 MB complessivi per richiesta.
Ogni email spedita tramite API riceve la firma DKIM esattamente come quelle inviate via SMTP. I messaggi inviati via API rientrano nello stesso conteggio di traffico del vostro piano, senza doppia fatturazione né configurazioni aggiuntive. Una risposta 200 indica che il messaggio è stato accettato per l’invio, mentre la consegna effettiva avviene in modo asincrono. Una chiave mancante o non valida restituisce 401, un account sospeso 403 e una richiesta malformata 400, con un corpo che, dove previsto, ne spiega il motivo.
Per campagne, newsletter e invii massivi resta lo SMTP autenticato, che potete usare in parallelo all’API con le stesse credenziali del vostro account. Su api.soloposta.biz trovate la documentazione tecnica completa, con tutti i campi supportati, i codici di risposta ed esempi in PHP e Node.js oltre a curl. Il servizio è aperto solo a chi rispetta il GDPR e la netiquette internazionale nella gestione degli indirizzi email.
Approfondimenti
- SMTP con SPF, DKIM e DMARC: record attivi e dominio mittente
- Servizi SMTP SoloPosta: panoramica su invio, traffico e regole d’uso