# 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](/cs/docs/sdks/) 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](/cs/docs/changelog/).

## 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ů](/cs/docs/api-reference/#object-ids).

- 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_` nebo `sed_`. Fungují všude, kde funguje ID `dom_`, 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á na `key_`.

## Související

  - [Přehled změn](/cs/docs/changelog/): Nové funkce a změny, od nejnovějších.
  - [Reference API](/cs/docs/api-reference/): Základní URL, autentizace a zdroje.

---
Zdroj: https://emailit.com/cs/docs/api-reference/versioning/