# API v2 /emails endpointy jsou nyní k dispozici

> Odesílejte, načítejte, aktualizujte a rušte e-maily programově pomocí našich nových API v2 endpointů pro e-maily.

2026-01-19 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

S radostí oznamujeme, že **e-mailové endpointy jsou nyní dostupné v API v2**! Nyní můžete odesílat, načítat, aktualizovat naplánované e-maily a rušit čekající e-maily – vše prostřednictvím našeho výkonného REST API.

## Nové endpointy

### Odeslání e-mailu

```
POST /v2/emails
```

Odešlete jeden e-mail jednomu nebo více příjemcům. Endpoint pro odesílání podporuje:

- **Více příjemců** – Odesílejte až 50 příjemcům (TO, CC, BCC dohromady)
- **Šablony** – Používejte aliasy nebo ID šablon s nahrazováním proměnných pomocí syntaxe `{{proměnná}}`
- **Přílohy** – Připojujte soubory prostřednictvím base64 obsahu nebo URL
- **Plánování** – Naplánujte e-maily pro budoucí doručení pomocí ISO 8601, Unix timestampů nebo přirozeného jazyka jako „zítra v 9 ráno"
- **Sledování** – Přepište výchozí nastavení sledování domény pro otevření a kliknutí
- **Metadata** – Připojte vlastní páry klíč-hodnota, které se ukládají a vrací s e-mailem
- **Idempotence** – Zabraňte duplicitním odesláním pomocí hlavičky `Idempotency-Key`

Každý příjemce obdrží své vlastní jedinečné ID e-mailu pro individuální sledování při odesílání na více adres.

### Získání e-mailu

```
GET /v2/emails/{id}
```

Načtěte podrobné informace o konkrétním e-mailu, včetně:

- Aktuální stav (čekající, naplánovaný, odeslaný, doručený, vrácený, zrušený)
- Surové hlavičky a obsah e-mailu
- Nastavení sledování
- Vlastní metadata
- Časové značky pro vytvoření a aktualizace

### Aktualizace naplánovaného e-mailu

```
POST /v2/emails/{id}
```

Přeplánujte e-mail, který je nastaven pro budoucí doručení. Můžete změnit naplánovaný čas, pokud je e-mail alespoň 3 minuty před odesláním.

### Zrušení e-mailu

```
POST /v2/emails/{id}/cancel
```

Zrušte naplánovaný nebo čekající e-mail před jeho odesláním. U naplánovaných e-mailů musí být zrušení požadováno alespoň 3 minuty před naplánovaným časem odeslání.

## Omezení rychlosti

Každá odpověď obsahuje hlavičky omezení rychlosti, takže můžete sledovat své využití:

- `ratelimit-limit` – Maximální počet požadavků za sekundu
- `ratelimit-remaining` – Zbývající požadavky v aktuální sekundě
- `ratelimit-daily-limit` – Maximální denní počet požadavků
- `ratelimit-daily-remaining` – Zbývající denní požadavky

## Dokumentace

Kompletní dokumentace s příklady kódu v Node.js, PHP, Python, Ruby, Go, Rust, Java, .NET a cURL je k dispozici:

- [Odeslání e-mailu](https://emailit.com/docs/api-reference/emails/send)
- [Získání e-mailu](https://emailit.com/docs/api-reference/emails/get)
- [Aktualizace naplánovaného e-mailu](https://emailit.com/docs/api-reference/emails/update)
- [Zrušení e-mailu](https://emailit.com/docs/api-reference/emails/cancel)

## Připravuje se: Templates API

Pracujeme na **Templates API**, které vám umožní programově vytvářet, aktualizovat a spravovat e-mailové šablony. Zůstaňte naladěni na tento vzrušující přírůstek!

## Oznámení o ukončení podpory API v1

**Důležité:** API v1 bylo označeno jako zastaralé a přestane fungovat na konci února 2026. Pokud stále používáte API v1, přemigrujte na API v2 co nejdříve.

Potřebujete pomoc s migrací? Podívejte se na naši [dokumentaci API v2](https://emailit.com/docs/api-reference) nebo se obraťte na náš tým podpory.

---

Source: https://emailit.com/cs/blog/api-v2-emailove-endpointy/