Ved at integrere Postal direkte med din applikation via API får du mere kontrol over, hvordan dine forsendelser sendes og modtages. Du kan læse mere om forskellen mellem API- og SMTP-integration her.
Integration består af to dele:
- API-forbindelse til at sende beskeder
- Webhook-forbindelse til at modtage status på sendte beskeder
Vi anbefaler, at du også integrerer webhooks for at modtage status på de beskeder, du sender, men det er valgfrit.
Klientbibliotek
Der findes flere færdige klientbiblioteker, som hjælper dig med at sende e-mails med Postal:
Disse biblioteker er open source og leveres af fællesskabet. Vi kan desværre ikke tilbyde support til bibliotekerne, men henviser til de respektive bibliotekers GitHub repository.
Send direkte til API’en
Du kan også oprette din egen forbindelse til Postal API. Der er to API’er:
- API til meddelelser . Få oplysninger om en sendt besked.
- Send API . Send beskeder fra din applikation.
Alle oplysninger om disse to API’er samt oplysninger om struktur, fejl og tilslutningsmuligheder kan findes i API-dokumentationen.
Når du bruger API’en, skal du bruge basis-URL’en. https://postal.oderland.com
For eksempel URL’en til at sende en besked: https://postal.oderland.com/api/v1/send/message
Modtag status via webhooks
Vi anbefaler, at du også modtager status på de beskeder, du sender. For at få status tilbage, skal du sende via API og ikke via SMTP. Med webhooks vil du være i stand til at
- Se, hvilke beskeder der bouncer, og du kan f.eks. fjerne adressen fra dit register.
- Se, hvilke links der klikkes på i din besked
- Se, hvor mange gange din besked er blevet åbnet
- Få oplysninger om andre fejl, der kan opstå, når du sender din besked.
Mere information om hvert webhook, dets svarstruktur og de tilgængelige hændelser kan findes i webhook-dokumentationen.
For at komme i gang med webhooks er vi nødt til at registrere dit callback i Postal. Når du har gennemført integrationen på dit websted, skal du kontakte os med din callback-URL til din applikation, så registrerer vi den.