Dokumentace a rozhraní
Základní parametry
| Endpoint | POST /api/v1/emails |
|---|---|
| Autentizace | API klíč projektu v hlavičce X-API-Key; projekt musí být předem registrován správcem služby |
| Formát obsahu | Textové i HTML tělo zprávy; při obou variantách se odesílá multipart/alternative |
| Zpracování | Synchronní — odpověď 200 potvrzuje předání zprávy SMTP serveru |
| Omezení příjemců | Vývojovým projektům může správce nastavit seznam povolených příjemců (whitelist); požadavek na adresu mimo seznam vrací 403 a neodešle se |
| Uchovávání dat | Služba je bezstavová; obsah zpráv se neukládá, provozní události se pouze protokolují |
Ukázka požadavku
Odeslání e-mailu — curl
curl -X POST /api/v1/emails \ -H 'Content-Type: application/json' \ -H 'X-API-Key: <klíč-projektu>' \ -d '{ "projectCode": "demo", "to": ["prijemce@example.cz"], "subject": "Potvrzení registrace", "textBody": "Dobrý den, vaše registrace byla schválena." }'
Úplný popis polí požadavku, validačních pravidel a chybových stavů naleznete v dokumentaci API.