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 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.