E-post API for utviklere – send transaksjonell e-post med Make Sender

Kort fortalt: Make Sender API er et REST-API for transaksjonell e-post. Du sender JSON over HTTPS til https://api.makesender.no/api/v1/ og autentiserer med Basic Auth. Du kan sende med maler fra Make, flette inn data per mottaker, legge ved filer, styre lister, kontakter og sperreliste, og få hendelser som levert, åpnet og bounce tilbake via signerte webhooks. Tjenesten har norsk support, driftes i Norge, og data lagres i Oslo.

Ordrebekreftelser, passordlenker, innloggingskoder og varsler må komme frem, og de må komme frem nå. Med Make Sender API sender du dem rett fra koden din, uten å drifte egen e-postserver, bygge IP-omdømme eller håndtere returer og blokkeringslister selv.

Her får du oversikt over hva API-et kan, hvordan det er bygd opp, og hva du må sette opp før første kall.

Hvorfor bruke et e-post-API?

Å sende e-post er lett. Å få den frem i innboksen er vanskeligere. En ny server uten historikk blir lett mistenkt for spam, og store volumer krever kø, nye forsøk og håndtering av bounces og spamklager. Med Make Sender API tar Make seg av leveringen, og du får et enkelt grensesnitt å sende mot.

Du integrerer, markedsavdelingen eier innholdet

Malene lages i Make-editoren. Du sender bare malnavnet og dataene som skal flettes inn. Vil markedsavdelingen endre tekst eller design på ordrebekreftelsen, gjør de det selv i Make, uten at du må deploye noe.

Slik er API-et bygd opp

• REST og JSON. Alle forespørsler og svar er JSON (Content-Type: application/json). Unntaket er vedlegg, som sendes som multipart/form-data.

• Basic Auth. Brukernavnet er API-brukernavnet ditt, og passordet er API-nøkkelen. Begge oppretter du i kontoinnstillingene.

• Felles adresse. Alle endepunkter ligger under https://api.makesender.no/api/v1/.

• Fem deler: Sendinger, kontaktlister, kontakter, sperreliste og webhooks.

Endepunkter

Sendinger

De viktigste parameterne:

• Malene støtter Liquid template language, så du kan bruke betingelser og løkker, ikke bare enkle plassholdere som {{ navn }}.

• Du kan flette recipient-variabler inn i template-variablene.

Alle parameterne sendes i selve forespørselen. Prefiksene viser hva feltet gjør: t: er maldata, v: er egne variabler og o: er innstillinger. Sender du via SMTP i stedet, setter du de samme opplysningene som X-Make--headere.

Kontaktlister

Hver liste har en alias-adresse. Sender du til den, får hver kontakt på listen sin egen kopi.

Kontakter

Hver kontakt kan ha egne felt i custom_fields, for eksempel navn og firma, som flettes inn i malene.

Sperreliste

Sperrelisten gjelder hele kontoen og alle lister. Make sender aldri til adresser som står der. Hver oppføring har en statuscode: bounce, complaint eller unsubscribe.

Webhooks

Webhooks setter du opp under Innstillinger → Webhooks i Make, ikke via API-et. Du kan ha opptil 16 endepunkter. Hvert endepunkt må bruke HTTPS, og kan gjelde alle domener eller bare ett.

Format: POST med JSON, med to deler: signature og event-data.

• Signering: HMAC-SHA256 av timestamp og token, med signeringsnøkkelen fra innstillingene. Avvis gamle tidsstempler og tokens du har sett før.

• Korrelasjon: job-id i varselet er den samme som i headeren X-Job-ID, så du kan koble hendelsen til dine egne data.

• Nye forsøk: Svar med 2xx innen 10 sekunder. Feilede leveranser prøves opptil 6 ganger. Etter 25 feil på rad slås endepunktet av.

• Idempotens: Samme hendelse kan komme flere ganger og i feil rekkefølge. Dedupliser på id og sorter på timestamp.

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

Grenser og feilhåndtering

Kom i gang

1. Få tilgang. Make Sender API er tilgjengelig for alle betalende kunder. Velg et abonnement etter månedlig volum.

2. Opprett et subdomene. For eksempel send.eksempel.no. Legg aldri DNS-postene på rotdomenet, for da tar MX-posten over den vanlige e-posten.

3. Legg inn DNS-postene fra tabellen under, og klikk «Verifiser» i Make.

4. Opprett en API-nøkkel i kontoinnstillingene. Legg den i en miljøvariabel eller et hemmelighetshvelv, aldri i klientkode eller et repo.

5. Sett opp webhooks under Innstillinger → Webhooks hvis du trenger leveringsstatus i ditt eget system.

6. Send første melding med POST /{domene}/messages, og sjekk at du får 201 Created.

DNS-poster på subdomenet

MX-posten sørger for at returmeldinger havner hos Make, slik at sperrelisten holdes oppdatert.

API eller SMTP?

Trenger du bare å peke et eksisterende system mot en SMTP-server, er Make Sender SMTP raskere å sette opp. API-et gir deg mer: lister, kontakter og sperreliste som du styrer fra koden, mer fleksibel batch-sending og strukturerte svar. Begge går gjennom den samme leveringsmotoren.

Levering og drift

• Etablert omdømme. Make sender fra IP-adresser med lang historikk, og fra norske servere med godt rykte hos norske internettleverandører.

• Overvåking. Leveringsrate, blokkeringslister og feedback loops overvåkes kontinuerlig.

• Automatisk sperreliste. Hard bounces og spamklager legges inn uten at du gjør noe.

• Dedikert IP. Ved store volumer kan du få egen IP-adresse og bygge ditt eget omdømme.

• Logger. I Make ser du status, feilkode og SMTP-respons for hver melding.

Personvern og datalagring

Make er et norsk selskap og lagrer kundedata på servere i Oslo, ikke hos en amerikansk skyleverandør. Make er databehandler. Avsenderen er ansvarlig for at det finnes grunnlag for å sende til mottakerne.

Support

Du får norsk support fra folk som kjenner både e-postlevering og API-et, ikke en chatbot eller et utenlandsk ticketsystem.

Dette får du hjelp med

• DNS-oppsett. Make hjelper deg å sette opp subdomene, SPF, DKIM og MX riktig, og sjekker at domenet blir verifisert.

• Teknisk rådgivning. Du kan få råd om integrasjon, batch-sending, webhooks og hvordan dere bør bruke maler og lister.

• Feilsøking. Kommer ikke en e-post frem, ser support på status, feilkode og SMTP-respons sammen med deg.

• Dialog med utviklerne deres. Support kan snakke direkte med teamet ditt når det trengs.

Står du fast eller har du noe du lurer på?

• Telefon: +47 21 64 00 10

• E-post: support@make.as

• Chat: i Make

• Hjelpeartikler: support.make.as

• Driftsstatus: status.make.as.

Ofte stilte spørsmål

Hvordan autentiserer jeg mot Make Sender API?
→ Med HTTP Basic Auth. Brukernavnet er API-brukernavnet ditt, og passordet er API-nøkkelen. Begge oppretter du i kontoinnstillingene i Make.

Hvilket format bruker API-et?
→ JSON over HTTPS. Unntaket er meldinger med vedlegg, som sendes som multipart/form-data.

Hva er rate limit for Make Sender API?
→ 200 forespørsler per minutt per API-nøkkel. Går du over, får du 429 Too Many Requests.

Kan jeg bruke maler fra Make når jeg sender via API?
→ Ja. Send malnavnet i template og dataene i t:variables. Malene støtter Liquid, så du kan bruke betingelser og løkker.

Hvordan sender jeg samme e-post til mange med personlig innhold?
→ Send flere adresser i to, og legg dataene for hver mottaker i recipient-variables. Alternativt kan du sende til en liste, der hver kontakt har egne felt.

Hvordan får jeg leveringsstatus inn i mitt eget system?
→ Sett opp webhooks under Innstillinger → Webhooks i Make. Du får hendelser som delivered, permanent_fail, opened, clicked og complained.

Hvordan verifiserer jeg at en webhook kommer fra Make?
→ Hvert varsel er signert med HMAC-SHA256 av timestamp og token, med signeringsnøkkelen fra innstillingene. Sammenlign med signature-feltet, og avvis gamle tidsstempler.

Kan jeg importere en sperreliste fra en annen leverandør?
→ Ja. Bruk POST /suppressions/import med en CSV-, Excel- eller JSON-fil på opptil 5 MB.

Hvor lagres dataene?
→ På servere i Oslo. Make er et norsk selskap og bruker ikke amerikanske skyleverandører.

Er Make Sender et alternativ til Mailgun, SendGrid og Postmark?
→ Ja. Make Sender dekker det samme behovet for transaksjonell e-post, med norsk datalagring og norsk support.

Ressurser

• Sett opp og verifiser et sendedomene