API klíč
API klíč je tajný řetězec (často dvojice identifikátor a secret), kterým se aplikace prokazuje službě při volání API nebo přihlášení k SMTP relay místo uživatelského jména a hesla člověka.
Klíč má mít omezená práva (jen odesílání, bez správy účtu), vlastní limity a má jít kdykoli zrušit nebo rotovat bez změny hesla k účtu. Pro každý systém (e-shop, CRM, automatizace) vytvořte zvláštní klíč, aby šlo při úniku zrušit jen ten jeden a v logu poznat, odkud zprávy přišly.
Klíč nikdy nepatří do kódu v repozitáři ani do front-endu; ukládá se do proměnných prostředí nebo správce tajemství. Služba ho má uchovávat jen jako hash a zobrazit celý pouze při vytvoření. Logy volání API s IP adresou a časem pomáhají odhalit zneužití.
Authorization: Bearer cl_8f2a1b3c:sk_9e7d6c5b4a3f2e1d…
# SMTP
uživatel: cl_8f2a1b3c
heslo: sk_9e7d6c5b4a3f2e1d…V TopEmail vytvoříte libovolný počet API klíčů clientId:secret s vlastním denním a minutovým limitem; stejný klíč slouží pro REST API i přihlášení k smtp.topemail.cz.