Reference
Verzování
API Emailitu je ve verzi 2. Jak se verze určuje, co se mění bez nové verze, zastaralé API v1 a přechod na ID objektů s předponou.
Verze API je součástí základní URL, takže každý požadavek uvádí verzi, pro kterou byl napsán. Tato stránka vysvětluje, které verze existují, co se může v rámci verze změnit a jak se v roce 2026 změnila ID objektů.
Verze
| Verze | Základní URL | Stav |
|---|---|---|
| v2 | https://api.emailit.com/v2 |
Aktuální. Vydaná v říjnu 2025. Vše v této referenci se týká v2. |
| v1 | https://api.emailit.com/v1 |
Zastaralá. Předchozí generace API. Nedostává žádné nové funkce a už není zdokumentovaná. |
Pokud ještě voláte v1, převeďte integraci na v2. Všechna SDK používají v2.
Změny v rámci v2
Emailit rozšiřuje v2 bez změny verze v URL. Tyto změny mohou přijít kdykoli:
- Nové endpointy a zdroje.
- Nové volitelné parametry požadavků a hlavičky.
- Nová pole v objektech odpovědí a v obsahu webhooků.
- Nové typy událostí, stavy a další hodnoty výčtů.
Pište klienty, kteří s nimi počítají: ignorujte pole odpovědí, která neznáte, neselhávejte na neznámém stavu nebo typu události a nespoléhejte na pořadí polí v objektu JSON.
Změny API oznamujeme v přehledu změn.
ID objektů
V lednu 2026 přešly všechny objekty na ID s předponou: předpona typu a za ní 27 písmen a číslic, například em_4KYof1ZzXndZE2VPi0DgULiekG8 pro e-mail nebo dom_4K468YrjOkR1wwdhqiO0G9XEUey pro doménu. Všechny endpointy tato ID přijímají a vracejí. Všechny předpony najdete v části ID objektů.
- ID ukládejte jako řetězce a porovnávejte je přesně. Rozlišují velikost písmen.
- Odesílací domény, které existovaly před změnou, si ponechávají ID začínající na
sd_nebosed_. Fungují všude, kde funguje IDdom_, takže ID domén nevalidujte podle předpony. - API klíče jsou tajné údaje, ne ID. Nové klíče začínají na
secret_a starší klíče bez předpony fungují dál. ID API klíče začíná nakey_.