# E-mailové API

> Odesílejte transakční e-maily jedním požadavkem HTTPS a pak je plánujte, rušte, odesílejte znovu nebo přeposílejte. Základní URL, autentizace, funkce a limity.

E-mailové API odesílá e-maily z vaší aplikace přes HTTPS místo připojení SMTP. Používejte ho pro transakční e-maily, jako jsou potvrzení registrace, obnovení hesla, účtenky a upozornění, zvlášť když chcete šablony, plánování, bezpečné opakování požadavků a samostatné ID pro každého příjemce.

## Jak to funguje

1. Vaše aplikace zavolá `POST /emails` s adresou odesílatele na ověřené odesílací doméně, s příjemci a s obsahem nebo šablonou.
2. Emailit požadavek zvaliduje, účtuje 1 kredit za každého příjemce a pro každého příjemce vytvoří jeden e-mail s vlastním ID `em_`.
3. Odpověď přijde hned se stavem `accepted`, nebo `scheduled`, pokud jste nastavili čas odeslání. Doručení probíhá na pozadí.
4. Emailit zprávu podepíše DKIM pro vaši doménu, provede kontroly spamu a doručí ji. Při dočasných chybách zkouší doručení znovu přibližně 21 hodin.
5. Každá změna stavu se zobrazí v **Email API → Emails** a odešle se na vaše [webhooky](/cs/docs/webhooks/).

## Základní URL a autentizace

| Položka | Hodnota |
| --- | --- |
| Základní URL | `https://api.emailit.com/v2` |
| Autentizace | `Authorization: Bearer secret_••••` s [API klíčem](/cs/docs/developers/api-keys/) |
| Tělo požadavku | JSON odeslaný s `Content-Type: application/json` |
| Endpoint pro odeslání | `POST /emails` |

Klíč s oprávněním **Full Access** může volat všechny endpointy. Klíč s oprávněním **Sending Only** může e-maily odesílat, přeplánovat, rušit, odesílat znovu a přeposílat a můžete ho omezit na jednu odesílací doménu. Podrobnosti najdete na stránce [Autentizace](/cs/docs/api-reference/authentication/).

## Odešlete e-mail

**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, Ada.</p>",
    "text": "Thanks for signing up, Ada."
  }'
```

**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, Ada.</p>',
  text: 'Thanks for signing up, Ada.',
});

console.log(email.id);
```

**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, Ada.</p>",
    "text": "Thanks for signing up, Ada.",
})
```

**PHP**

```php
$emailit = Emailit::client(getenv('EMAILIT_API_KEY'));

$email = $emailit->emails()->send([
    'from' => 'Acme <hello@acme.com>',
    'to' => 'ada@example.com',
    'subject' => 'Welcome to Acme',
    'html' => '<p>Thanks for signing up, Ada.</p>',
    'text' => 'Thanks for signing up, Ada.',
]);
```

Úspěšný požadavek vrací `200` s novým e-mailem:

```json
{
  "object": "email",
  "id": "em_33VtK8mRq1xZp7LwN4cY2bHsDfa",
  "token": "33VtK8m4XcPq2RwZ7nLb1YsTgHd",
  "message_id": "<33VtK8m4XcPq2RwZ7nLb1YsTgHd@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": ["ada@example.com"],
  "subject": "Welcome to Acme",
  "status": "accepted",
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.418203Z",
  "tracking": { "loads": false, "clicks": false }
}
```

Nové workspace začínají v režimu sandbox a mohou odesílat jen na e-mailové adresy účtů členů workspace. Než začnete odesílat komukoli jinému, [požádejte o produkční přístup](/cs/docs/workspaces/production-access/).

## Co můžete dělat

  - [Odeslání e-mailu](/cs/docs/email-api/send-email/): Adresy odesílatele, příjemci, obsah, šablony, měření a všechny chyby.
  - [Přílohy](/cs/docs/email-api/attachments/): Přikládejte soubory v base64 nebo z URL a vkládejte obrázky přímo do e-mailu.
  - [Plánování](/cs/docs/email-api/scheduling/): Odešlete e-mail později, přeplánujte ho, nebo ho zrušte, než odejde.
  - [Idempotence](/cs/docs/email-api/idempotency/): Opakujte požadavky bezpečně, aniž byste stejný e-mail odeslali dvakrát.
  - [Hlavičky a metadata](/cs/docs/email-api/headers-and-metadata/): Vlastní hlavičky, List-Unsubscribe a metadata, která se vracejí ve webhoocích.
  - [Opakované odeslání a přeposlání](/cs/docs/email-api/retry-and-forward/): Odešlete znovu neúspěšný nebo zadržený e-mail, nebo odeslaný e-mail přepošlete někomu jinému.
  - [Šablony](/cs/docs/templates/): Uložte design jednou a odesílejte ho podle aliasu s proměnnými Temple.
  - [Reference API pro e-maily](/cs/docs/api-reference/emails/): Všechny endpointy pro e-maily s parametry a odpověďmi.

## Limity

| Limit | Hodnota |
| --- | --- |
| Příjemci v jednom požadavku | 50 v `to`, 50 v `cc` a 50 v `bcc` |
| Velikost zprávy | 40 MB včetně zakódovaných příloh |
| Příloha stažená z URL | 25 MB, časový limit stahování 30 sekund |
| Okno idempotence | 24 hodin |
| Rychlost odesílání (výchozí) | 2 e-maily za sekundu a 5 000 e-mailů denně na workspace, společně se SMTP |
| Přeposílání | 3 přeposlání za hodinu na workspace |
| Přeplánování nebo zrušení naplánovaného e-mailu | Nejpozději 3 minuty před časem odeslání |
| Okno pro opakované odeslání | 30 dní od vytvoření původního e-mailu |

Limity rychlosti počítají příjemce, takže jeden požadavek na 10 příjemců spotřebuje 10 z vašeho limitu za sekundu i z denního limitu. Workspace v tarifech Pro a Business dostávají automatická navýšení podle kondice odesílání a každý workspace může požádat o vyšší limity v panelu **Sending Limits** na úvodní stránce webového rozhraní. Viz [Limity](/cs/docs/limits/) a [Limity rychlosti](/cs/docs/api-reference/rate-limits/).

## Kredity

Každý příjemce stojí 1 kredit a počítají se adresy v `to`, `cc` i `bcc`. Pokud workspace nemá dost kreditů pro všechny příjemce, požadavek selže s `402` a nic se neodešle. Opakovaná odeslání a přeposlání se účtují jako nová odeslání.

| Akce | Kredity |
| --- | --- |
| E-mail odeslaný přes API nebo SMTP (za příjemce) | 1 |
| Přijatý e-mail | 1 |
| E-mail z kampaně (za příjemce) | 2 |
| Spuštění automatizace | 3 |
| Ověření e-mailu (za adresu) | 5 |

Jak se čerpají kredity v ceně tarifu a zakoupené kredity, najdete na stránce [Kredity](/cs/docs/billing/credits/).

## Další kroky

  - [Rychlý začátek s API](/cs/docs/quickstart/api/): Odešlete první e-mail během několika minut.
  - [Přidání odesílací domény](/cs/docs/domains/add-a-domain/): Ověřte doménu, ze které odesíláte.
  - [Nastavení webhooků](/cs/docs/webhooks/set-up/): Přijímejte události doručení, nedoručení a zapojení.
  - [API, nebo SMTP?](/cs/docs/get-started/api-or-smtp/): Porovnejte e-mailové API se SMTP relay.

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