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.
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" }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 eget innhold eller bruk en 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.
Forespørselsgrenser og bruksvarsler
En forespørselsgrense for hele kontoen hindrer en travel eller feilslått jobb i å oversvømme mottakerne dine, og vi sender deg e-post ved 80 % og 100 % av den inkluderte mengden før overforbruk starter.
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.
SMTP-relé
I betalte abonnementer sender apper og utvidelser som bare støtter SMTP via smtp.mailhuset.com, med de samme reglene, hendelsene og aktivitetsloggen som API-et.
Vanlige spørsmål
- Må jeg bruke en SDK?
- Nei. API-et bruker REST over HTTPS, så du kan bruke alle språk som støtter autentiserte HTTP-kall. SDK-ene sparer deg for rutinekoden, men er ikke 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 når en forespørselsgrense?
- API-et returnerer 429 med en tydelig feilkode du kan trappe ned på. Grensen gjelder hele kontoen, og gratisabonnementet stopper ved den inkluderte mengden i stedet for å fakturere overforbruk.
- Kan jeg sende via SMTP i stedet for API-et?
- Ja, i betalte abonnementer. Pek appen din mot smtp.mailhuset.com på port 587 eller 465 med en SMTP-pålogging fra dashbordet. E-post sendt slik følger de samme reglene som API-et: verifiserte avsendere, utestengte adresser og grenser.
Relatert lesing
Send din første API-forespørsel på få minutter
Opprett en avgrenset nøkkel, send inn én JSON-kropp, og se meldingen bevege seg gjennom aktivitetsloggen din.