# Reference API

> REST API Emailitu v kostce. Základní URL, autentizace, požadavky a odpovědi v JSON, ID objektů, verzování a všechny zdroje, které můžete spravovat.

API Emailitu je REST API dostupné přes HTTPS. Posíláte JSON, dostáváte zpět JSON a každý požadavek autentizujete bearer tokenem. Používejte ho k odesílání e-mailů a ke správě všeho ostatního ve workspace: odesílacích domén, API klíčů, kontaktů, seznamů kontaktů, kampaní, šablon, webhooků a dalšího.

## Základní URL

Každý požadavek míří na základní URL verze 2:

```text
https://api.emailit.com/v2
```

Cesty v této referenci jsou relativní k ní. Například `POST /emails` znamená `POST https://api.emailit.com/v2/emails`.

## Pošlete první požadavek

Tento požadavek odešle jeden e-mail. Odesílatele nahraďte adresou na [ověřené odesílací doméně](/cs/docs/domains/verification/) a do `EMAILIT_API_KEY` nastavte jeden ze svých [API klíčů](/cs/docs/developers/api-keys/).

**cURL**

```bash
curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Welcome to Acme",
    "html": "<p>Thanks for signing up.</p>"
  }'
```

**Node.js**

```javascript
import { Emailit } from '@emailit/node';

const emailit = new Emailit(process.env.EMAILIT_API_KEY);

const email = await emailit.emails.send({
  from: 'Acme <hello@acme.com>',
  to: 'ada@example.com',
  subject: 'Welcome to Acme',
  html: '<p>Thanks for signing up.</p>',
});
```

**Python**

```python
import os
from emailit import EmailitClient

client = EmailitClient(os.environ["EMAILIT_API_KEY"])

email = client.emails.send({
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Welcome to Acme",
    "html": "<p>Thanks for signing up.</p>",
})
```

Odpovědí je nový objekt e-mailu s jeho ID (`em_…`) a stavem `accepted`. Všechny možnosti najdete na stránce [Odeslání e-mailu](/cs/docs/api-reference/emails/send/).

## Autentizace

V hlavičce `Authorization` předejte API klíč, nebo přístupový token OAuth:

```http
Authorization: Bearer secret_••••••••••••••••••••••••••••••••
```

API klíče začínají na `secret_` a patří do jednoho workspace. Klíč má oprávnění `full` (všechny endpointy), nebo `sending` (jen endpointy pro odesílání) a klíč pro odesílání lze omezit na jednu odesílací doménu. Požadavky bez platného klíče selžou s `401`. Viz [Autentizace](/cs/docs/api-reference/authentication/).

## Požadavky a odpovědi

- **JSON dovnitř, JSON ven.** Těla požadavků posílejte jako JSON s `Content-Type: application/json`. Tělo, které není platný JSON, vrátí `400` se zprávou `Invalid JSON in request body`. Tělo požadavku smí mít nejvýše 50 MB.
- **Metody.** `GET` čte, `POST` vytváří a upravuje a `DELETE` maže. API nepoužívá `PUT` ani `PATCH`.
- **Objekty.** Každý objekt má pole `object`, které určuje jeho typ (`email`, `domain`, `api_key`, `audience`, `subscriber`, `contact`, …), a `id`.
- **Časová razítka.** Data jsou řetězce podle ISO 8601 v UTC s přesností na mikrosekundy, například `2026-10-01T09:30:12.482913Z`. Nenastavená pole mají hodnotu `null`.
- **Výpisy.** Endpointy pro výpisy jsou stránkované a většina přijímá filtry a řazení. Viz [Stránkování](/cs/docs/api-reference/pagination/) a [Filtrování](/cs/docs/api-reference/filtering/).
- **Chyby.** Neúspěšné požadavky vracejí stavový kód `4xx` nebo `5xx` a tělo JSON s vysvětlením problému. Viz [Chyby](/cs/docs/api-reference/errors/).

## ID objektů

ID jsou řetězce složené z předpony typu a 27 písmen a číslic, například `em_4KYof1ZzXndZE2VPi0DgULiekG8`. ID rozlišují velikost písmen a jsou přibližně seřazená podle času vytvoření.

| Předpona | Objekt | Předpona | Objekt |
| --- | --- | --- | --- |
| `em_` | E-mail | `aud_` | Seznam kontaktů |
| `dom_` | Odesílací doména | `sub_` | Odběratel |
| `key_` | API klíč | `con_` | Kontakt |
| `tem_` | Šablona | `cmp_` | Kampaň |
| `sup_` | Blokace | `frm_` | Formulář |
| `wh_` | Webhook | `fsub_` | Odpověď formuláře |
| `whr_` | Požadavek webhooku | `aut_` | Automatizace |
| `evt_` | Událost | `aur_` | Spuštění automatizace |
| `dmr_` | DMARC report | `ev_` | Ověření e-mailu |
| `evl_` | Seznam k ověření | | |

Některé zdroje přijímají v cestě také čitelný identifikátor. Domény, API klíče, seznamy kontaktů, kampaně a webhooky přijímají svůj název (`GET /domains/acme.com`). Kontakty a blokované adresy přijímají e-mailovou adresu a odběratelé e-mailovou adresu kontaktu. Názvy a adresy se speciálními znaky zakódujte do URL. Domény vytvořené před přechodem na ID `dom_` si ponechávají své ID `sd_` nebo `sed_` a tato ID stále fungují.

## Verzování

Aktuální verze je `v2` a je součástí základní URL. Nová pole a endpointy se do `v2` přidávají bez změny verze, takže klienty pište tak, aby ignorovaly pole, která neznají. Viz [Verzování](/cs/docs/api-reference/versioning/).

## Zdroje

  - [E-maily](/cs/docs/api-reference/emails/): Odesílejte e-maily, čtěte zprávy a jejich obsah a e-maily plánujte, rušte, odesílejte znovu nebo přeposílejte.
  - [Domény](/cs/docs/api-reference/domains/): Přidávejte odesílací domény, čtěte jejich DNS záznamy a ověřujte je.
  - [DMARC reporty](/cs/docs/api-reference/dmarc/): Čtěte souhrnné a forenzní DMARC reporty domény, nebo nahrajte vlastní.
  - [API klíče](/cs/docs/api-reference/api-keys/): Vytvářejte, přejmenovávejte, znovu generujte a mažte API klíče workspace.
  - [Seznamy kontaktů](/cs/docs/api-reference/audiences/): Spravujte seznamy odběratelů pro kampaně a přihlašovací formuláře.
  - [Odběratelé](/cs/docs/api-reference/audiences/subscribers/): Přidávejte, upravujte a odebírejte odběratele seznamu kontaktů.
  - [Kontakty](/cs/docs/api-reference/contacts/): Spravujte profily kontaktů a vlastní pole, jednotlivě, nebo hromadně.
  - [Kampaně](/cs/docs/api-reference/campaigns/): Vytvářejte kampaně, vybírejte pro ně seznamy kontaktů a kampaně odešlete hned, nebo je naplánujte.
  - [Automatizace](/cs/docs/api-reference/automations/): Sestavujte workflow ze spouštěčů a kroků, spouštějte je a procházejte jejich spuštění.
  - [Formuláře](/cs/docs/api-reference/forms/): Vytvářejte přihlašovací formuláře, publikujte je a vyměňujte jejich veřejný token.
  - [Šablony](/cs/docs/api-reference/templates/): Vytvářejte verze šablon, pro každý alias jednu publikujte a odesílejte s ní.
  - [Blokované adresy](/cs/docs/api-reference/suppressions/): Čtěte a spravujte adresy, na které Emailit nebude odesílat.
  - [Webhooky](/cs/docs/api-reference/webhooks/): Registrujte endpointy, které přijímají podepsaná oznámení o událostech.
  - [Události](/cs/docs/api-reference/events/): Čtěte proud událostí, ze kterého vycházejí webhooky: doručení, nedoručení, otevření a další.
  - [Ověřování e-mailů](/cs/docs/api-reference/email-verifications/): Ověřte jednu adresu v reálném čase.
  - [Seznamy k ověření](/cs/docs/api-reference/email-verifications/lists/): Ověřte až 10 000 adres najednou a vyexportujte výsledky.

Všechny endpointy a oprávnění, která potřebují, v jedné tabulce najdete na stránce [Všechny endpointy](/cs/docs/api-reference/endpoints/).

## SDK

Oficiální knihovny obalují API pro nejčastější jazyky. Jsou open source na [GitHubu](https://github.com/emailit).

| Jazyk | Balíček | Návod |
| --- | --- | --- |
| Node.js | `@emailit/node` | [Node.js](/cs/docs/frameworks/nodejs/) |
| Python | `emailit` | [Python](/cs/docs/frameworks/python/) |
| PHP | `emailit/emailit-php` | [PHP](/cs/docs/frameworks/php/) |
| Laravel | `emailit/emailit-laravel` | [Laravel](/cs/docs/frameworks/laravel/) |
| Ruby | `emailit` | [Ruby on Rails](/cs/docs/frameworks/rails/) |
| Go | `github.com/emailit/emailit-go/v2` | [Go](/cs/docs/frameworks/go/) |
| Java | `com.emailit` | [Java](/cs/docs/frameworks/java/) |
| .NET | `Emailit` | [.NET](/cs/docs/frameworks/dotnet/) |
| Rust | `emailit` | [SDK](/cs/docs/sdks/) |

## Webhooky a události

Místo opakovaného dotazování na změny stavu si zaregistrujte [webhook](/cs/docs/webhooks/) a Emailit bude na váš endpoint posílat podepsané dávky událostí hned, jak nastanou: doručení, nedoručení, otevření, prokliky, nové kontakty a další. Stejné události jsou dostupné přes [Výpis událostí](/cs/docs/api-reference/events/list/). Úplný seznam najdete na stránce [Typy událostí](/cs/docs/webhooks/event-types/).

## MCP server

Hostovaný MCP server na `https://api.emailit.com/mcp` umožňuje AI asistentům, jako jsou ChatGPT, Claude, Cursor, Codex a Grok, volat toto API za vás: 109 nástrojů pokrývá všechny zdroje na této stránce. Asistenti se přihlašují přes OAuth, nebo používají API klíč, se stejnými oprávněními. Viz [MCP server](/cs/docs/mcp/) a [referenci nástrojů](/cs/docs/mcp/tools/).

## Související

  - [Autentizace](/cs/docs/api-reference/authentication/): API klíče, oprávnění, omezení na doménu a tokeny OAuth.
  - [Limity rychlosti](/cs/docs/api-reference/rate-limits/): Limity odesílání, hlavičky odpovědí a jak zpomalit.
  - [Chyby](/cs/docs/api-reference/errors/): Formáty chyb, stavové kódy a časté opravy.
  - [Odeslání prvního e-mailu](/cs/docs/quickstart/api/): Rychlý začátek krok za krokem, od API klíče až do schránky.

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