E-post-API

Send e-post med ett autentisert API-kall.

Ett enkelt REST-endepunkt sender den transaksjonelle e-posten din. Autentiser med en avgrenset nøkkel, send inn JSON, og få en meldings-ID du kan følge gjennom aktivitetsloggen. Bruk en SDK eller ren HTTP, alt etter hva som passer oppsettet ditt.

POST /v1/email
curl https://api.mailhuset.com/v1/email \
  -H "Authorization: Bearer mh_live_..." \
  -d '{"from":"you@yourapp.com",
       "to":"user@example.com",
       "subject":"Reset your password",
       "template":"password-reset",
       "model":{"name":"Amara"}}'

→ 200 { "id":"msg_a91f2c", "status":"queued" }
REST + JSON
Ett endepunkt for å sende
Avgrensede nøkler
Roter eller tilbakekall når som helst
Idempotent
Trygt å prøve på nytt
SDK eller HTTP
Send slik du bygger

Et enkelt API som ikke står i veien

Alt du trenger for å sende pålitelig, og ingenting du må sette opp før den første meldingen går ut.

Send rått eller med mal

Send HTML og tekst direkte, eller referer til en lagret mal med alias og send med en modell av verdier som flettes inn.

Avgrensede API-nøkler

Opprett nøkler som bare kan sende, roter dem etter en tidsplan, og tilbakekall en hvilken som helst nøkkel i det øyeblikket du trenger det.

Idempotensnøkler

Legg ved en idempotensnøkkel, så sender en gjentatt forespørsel aldri to ganger, selv om nettverket mister svaret ditt.

Vedlegg og headere

Legg til vedlegg, egendefinerte headere, svar-til og etiketter på en hvilken som helst melding, alt i samme JSON-kropp.

Rategrenser og forbrukstak

Rategrenser per nøkkel og et forbrukstak for kontoen hindrer en travel eller feilende jobb i å løpe løpsk med regningen din.

Meldings-ID-er og status

Hver sending returnerer en meldings-ID og status, så du kan slå den opp, følge tidslinjen eller matche den mot en webhook.

Vanlige spørsmål

Må jeg bruke en SDK?
Nei. API-et er ren REST over HTTPS, så alle språk som kan lage et autentisert API-kall fungerer. SDK-er finnes for å spare deg for standardkode, ikke fordi de er påkrevd.
Hvordan hindrer jeg at et nytt forsøk sender to ganger?
Send en idempotensnøkkel med forespørselen. Hvis samme nøkkel kommer inn igjen, returnerer vi det opprinnelige resultatet i stedet for å sende en kopi til.
Kan jeg begrense hva en nøkkel kan gjøre?
Ja. Nøkler er avgrenset, så en sendenøkkel kan ikke administrere kontoen din, og du kan rotere eller tilbakekalle en hvilken som helst nøkkel når som helst.
Hva skjer hvis jeg treffer en rategrense?
API-et returnerer en tydelig status du kan trappe ned på. Du setter grensene per nøkkel, og et forbrukstak beskytter kontoen som helhet.

Send din første forespørsel på minutter

Opprett en avgrenset nøkkel, send inn én JSON-kropp, og se meldingen bevege seg gjennom aktivitetsloggen din.