E-mail API til udviklere – send transaktionelle e-mails med Make Sender

Kort fortalt: Make Sender API er et REST-API til transaktionel e-mail. Du sender JSON over HTTPS til https://api.makesender.no/api/v1/ og godkender med Basic Auth. Du kan sende med skabeloner fra Make, flette data ind per modtager, vedhæfte filer, styre lister, kontakter og blokeringsliste, og modtage hændelser som leveret, åbnet og bounce retur via signerede webhooks. Tjenesten har norsk support, driftes i Norge, og data gemmes i Oslo.

Ordrebekræftelser, links til nulstilling af adgangskode, loginkoder og notifikationer skal frem, og de skal frem med det samme. Med Make Sender API sender du dem direkte fra din kode uden at drifte din egen mailserver, opbygge IP-omdømme eller håndtere retursvar og blokeringslister selv.

Her får du et overblik over, hvad API'et kan, hvordan det er opbygget, og hvad du skal opsætte inden det første kald.

Hvorfor bruge et e-mail-API?

Det er nemt at sende en e-mail. At få den frem til indbakken er sværere. En ny server uden historik bliver hurtigt mistænkt for spam, og store mængder kræver køstyring, nye forsøg og håndtering af bounces og spamklager. Med Make Sender API tager Make sig af leveringen, og du får en enkel grænseflade at sende til.

Du integrerer, marketingafdelingen ejer indholdet

Skabelonerne oprettes i Make-editoren. Du sender blot skabelonnavnet og de data, der skal flettes ind. Vil marketingafdelingen ændre tekst eller design på ordrebekræftelsen, gør de det selv i Make, uden at du behøver at deploye noget.

Sådan er API'et opbygget

• REST og JSON. Alle anmodninger og svar er i JSON (Content-Type: application/json). Undtagelsen er vedhæftede filer, der sendes som multipart/form-data.

• Basic Auth. Brugernavnet er dit API-brugernavn, og adgangskoden er din API-nøgle. Begge dele opretter du i kontoindstillingerne.

• Fælles adresse. Alle slutpunkter ligger under https://api.makesender.no/api/v1/.

• Fem områder: Forsendelser, kontaktlister, kontakter, blokeringsliste og webhooks.

Slutpunkter

Forsendelser

De vigtigste parametre:

• Skabelonerne understøtter Liquid template language, så du kan bruge betingelser og loops, ikke kun simple pladsholdere som {{ navn }}.

• Du kan flette recipient-variables ind i template-variables.

Alle parametre sendes i selve anmodningen. Præfikserne viser feltets funktion: t: er skabelondata, v: er brugerdefinerede variabler, og o: er indstillinger. Sender du via SMTP i stedet, angiver du de samme oplysninger som X-Make--headere.

Kontaktlister

Hver liste har en aliasadresse. Sender du til den, modtager hver kontakt på listen sin egen kopi.

Kontakter

Hver kontakt kan have brugerdefinerede felter i custom_fields, for eksempel navn og virksomhed, som flettes ind i skabelonerne.

Blokeringsliste

Blokeringslisten gælder for hele kontoen og alle lister. Make sender aldrig til adresser, der står her. Hver post har en statuscode: bounce, complaint eller unsubscribe.

Webhooks

Webhooks opsættes under Indstillinger → Webhooks i Make, ikke via API'et. Du kan have op til 16 slutpunkter. Hvert slutpunkt skal bruge HTTPS og kan gælde for alle domæner eller blot et enkelt.

Format: POST med JSON, bestående af to dele: signature og event-data.

• Signering: HMAC-SHA256 af timestamp og token med signeringsnøglen fra indstillingerne. Afvis ældre tidsstempler og tokens, du allerede har set.

• Korrelation: job-id i notifikationen svarer til værdien i headeren X-Job-ID, så du kan koble hændelsen til dine egne data.

• Gentagne forsøg: Svar med 2xx inden for 10 sekunder. Mislykkede leveringer forsøges op til 6 gange. Efter 25 fejl i træk deaktiveres slutpunktet.

• Idempotens: Samme hændelse kan leveres flere gange og ude af rækkefølge. Deduplicer på id og sorter efter timestamp.

• Test: Knappen «Send test notification» afsender eksempelnotifikationer med headeren X-Webhook-Test: true.

Grænser og fejlhåndtering

Kom godt i gang

1. Få adgang. Make Sender API er tilgængeligt for alle betalende kunder. Vælg et abonnement baseret på månedlig volumen.

2. Opret et subdomæne. For eksempel send.eksempel.dk. Placer aldrig DNS-posterne på roddomænet, da MX-posten i så fald overtager den normale e-mailadresse.

3. Tilføj DNS-posterne fra tabellen nedenfor, og klik på «Verificer» i Make.

4. Opret en API-nøgle i kontoindstillingerne. Gem den i en miljøvariabel eller en hemmelighedshåndtering, aldrig i klientkode eller i et versionsstyringsarkiv.

5. Opsæt webhooks under Indstillinger → Webhooks, hvis du vil have leveringsstatus ind i dit eget system.

6. Send første besked med POST /{domæne}/messages, og kontroller, at du modtager 201 Created.

DNS-poster på subdomænet

MX-posten sikrer, at returbeskeder leveres til Make, så blokeringslisten holdes opdateret.

API eller SMTP?

Skal du blot pege et eksisterende system mod en SMTP-server, er Make Sender SMTP hurtigere at sætte op. API'et giver mere kontrol: lister, kontakter og blokeringsliste kan styres direkte via kode, batch-udsendelser er mere fleksible, og du modtager strukturerede svar. Begge løsninger benytter samme leveringsmotor.

Levering og drift

• Etableret omdømme. Make sender fra IP-adresser med lang historik og fra norske servere med godt omdømme hos internetudbydere.

• Overvågning. Leveringsrate, blokeringslister og feedback loops overvåges kontinuerligt.

• Automatisk blokeringsliste. Hard bounces og spamklager tilføjes automatisk, uden at du skal foretage dig noget.

• Dedikeret IP. Ved store voluminer kan du få en dedikeret IP-adresse og opbygge dit eget omdømme.

• Logfiler. I Make kan du se status, fejlkode og SMTP-svar for hver besked.

Databeskyttelse og datalagring

Make er en norsk virksomhed og opbevarer kundedata på servere i Oslo, ikke hos en amerikansk cloud-leverandør. Make fungerer som databehandler. Afsenderen har ansvaret for, at der er det nødvendige grundlag for at sende til modtagerne.

Support

Du får norsk support fra specialister, der kender både maillevering og API'et, ikke fra en chatbot eller et eksternt ticketsystem.

Dette kan vi hjælpe med

• DNS-konfiguration. Make hjælper dig med at opsætte subdomæne, SPF, DKIM og MX korrekt og sikrer, at domænet bliver verificeret.

• Teknisk rådgivning. Du kan få rådgivning om integration, batch-udsendelser, webhooks og den optimale brug af skabeloner og lister.

• Fejlfinding. Hvis en e-mail ikke når frem, gennemgår support status, fejlkode og SMTP-svar sammen med dig.

• Dialog med udviklere. Support kan have direkte dialog med dit udviklingsteam efter behov.

Har du brug for hjælp eller har spørgsmål?

• Telefon: +47 21 64 00 10

• E-mail: support@make.as

• Chat: i Make

• Hjælpeartikler: support.make.as

• Driftsstatus: status.make.as.

Ofte stillede spørgsmål

Hvordan godkender jeg mod Make Sender API?
→ Med HTTP Basic Auth. Brugernavnet er dit API-brugernavn, og adgangskoden er din API-nøgle. Begge dele opretter du under kontoindstillingerne i Make.

Hvilket format anvender API'et?
→ JSON over HTTPS. Undtagelsen er beskeder med vedhæftede filer, som sendes som multipart/form-data.

Hvad er grænsen for rate limit på Make Sender API?
→ 200 anmodninger per minut per API-nøgle. Overskrides grænsen, modtager du 429 Too Many Requests.

Kan jeg bruge skabeloner fra Make, når jeg sender via API?
→ Ja. Send skabelonnavnet i template og variablerne i t:variables. Skabelonerne understøtter Liquid, så du kan anvende betingelser og loops.

Hvordan sender jeg samme e-mail til mange modtagere med individuelt indhold?
→ Angiv flere adresser i to, og placer de individuelle modtagerdata i recipient-variables. Alternativt kan du sende til en liste, hvor hver kontakt har egne felter.

Hvordan får jeg leveringsstatus overført til mit eget system?
→ Opsæt webhooks under Indstillinger → Webhooks i Make. Du modtager hændelser som delivered, permanent_fail, opened, clicked og complained.

Hvordan verificerer jeg, at en webhook stammer fra Make?
→ Hver meddelelse signeres med HMAC-SHA256 af timestamp og token ved brug af signeringsnøglen fra indstillingerne. Sammenlign med feltet signature, og afvis forældede tidsstempler.

Kan jeg importere en blokeringsliste fra en anden leverandør?
→ Ja. Brug POST /suppressions/import med en CSV-, Excel- eller JSON-fil på op til 5 MB.

Hvor opbevares dataene?
→ På servere i Oslo. Make er en norsk virksomhed og anvender ikke amerikanske cloud-udbydere.

Er Make Sender et alternativ til Mailgun, SendGrid og Postmark?
→ Ja. Make Sender løser de samme opgaver inden for transaktionel e-mail, kombineret med nordisk datalagring og lokal support.

Ressourcer

• Opsæt og verificer et afsenderdomæne

• Hvad er transaktionel e-mail?