> ## Documentation Index
> Fetch the complete documentation index at: https://developers.smsmanager.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

JSON API v2 je hlavní API SmsManageru pro odesílání zpráv přes SMS, Viber a WhatsApp. Každý požadavek je autentizován vaším API klíčem a většina endpointů přijímá JSON tělo, které vám umožňuje cílit až 10 příjemců, definovat multikanálové toky, plánovat doručení a přijímat doručovací callbacky. Pokud migrujete ze starší integrace, všimněte si, že JSON API v1, HTTP API a XML API jsou zastaralé — pro všechnu novou práci byste měli používat v2.

## Základní URL

```text theme={null}
https://api.smsmngr.com/v2
```

Všechny endpointy v této referenci jsou relativní k této základní URL.

## Autentizace

JSON API v2 používá autentizaci API klíčem. Pro všechny `POST` endpointy předejte klíč v hlavičce požadavku `x-api-key`:

```http theme={null}
x-api-key: YOUR_API_KEY
```

Endpoint `GET /simple/message` je jedinou výjimkou — přijímá klíč jako query parametr `apikey`.

Svůj API klíč najdete v [nastavení účtu](https://app.smsmanager.com/api-cloud). Udržujte svůj klíč soukromý; kdokoli, kdo jej drží, může odesílat zprávy vaším jménem.

Pro širší vysvětlení autentizace napříč SmsManager API vizte [Průvodce autentizací](/cs/authentication).

## Souhrn endpointů

| Metoda | Endpoint          | Popis                                                      |
| ------ | ----------------- | ---------------------------------------------------------- |
| `POST` | `/message`        | Odeslat zprávu až 10 příjemcům                             |
| `POST` | `/messages`       | Odeslat dávku až 10 objektů zpráv (celkem až 100 příjemců) |
| `GET`  | `/simple/message` | Odeslat zprávu přes query parametry — nevyžaduje JSON tělo |
| `POST` | `/simple/message` | Odeslat zprávu přes form-encoded tělo                      |

## Formát požadavku

`POST /message` a `POST /messages` očekávají tělo `Content-Type: application/json`. Endpointy `/simple/message` používají query parametry (GET) nebo `application/x-www-form-urlencoded` (POST).

## Běžná pole požadavku

Následující pole jsou sdílena mezi `POST /message` a `POST /messages`. Každý objekt zprávy, který odešlete, může obsahovat jakoukoli jejich kombinaci.

| Pole            | Typ                    | Povinné | Popis                                                                                                                                                |
| --------------- | ---------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `body`          | string (max 1000)      | Ano\*   | Text zprávy. Povinné, pokud každý kanál flow nedefinuje svůj vlastní `body`.                                                                         |
| `to`            | array (1–10 položek)   | Ano     | Seznam objektů příjemců, každý obsahující řetězec `phone_number`.                                                                                    |
| `flow`          | array                  | Ne      | Seřazený seznam objektů kanálů (`sms`, `viber`, `whatsapp_text`, `whatsapp_template`). SmsManager zkouší každý kanál v pořadí, dokud jeden neuspěje. |
| `callback`      | string (URI)           | Ne      | Webhook URL pro příjem oznámení o stavu doručení této zprávy.                                                                                        |
| `tag`           | string                 | Ne      | Štítek pro seskupování zpráv. Vestavěné hodnoty: `promotional` (výchozí), `transactional`, `priority`. Přijímá vlastní řetězce.                      |
| `datetime`      | string (ISO 8601, UTC) | Ne      | Naplánovat zprávu na budoucí UTC datetime, např. `2025-06-01T09:00:00Z`.                                                                             |
| `delivery_time` | object                 | Ne      | Omezit doručení na časové okno: `days` (pole názvů dní v týdnu), `start` (HH:MM), `end` (HH:MM), `tz` (IANA časové pásmo, výchozí `UTC`).            |
| `params`        | object                 | Ne      | Speciální parametry zpracování (např. zkrácení odkazů). Podrobnosti kontaktujte podporu SmsManager.                                                  |
| `payload`       | object                 | Ne      | Libovolná klíč-hodnota data, která SmsManager vrací v každé webhook události pro tuto zprávu.                                                        |

<Note>
  **JSON API v1 je zastaralé.** Všechny nové integrace by měly cílit JSON API v2 (`https://api.smsmngr.com/v2`). Zastaralé jsou také HTTP API a XML API.
</Note>

## Prozkoumejte endpointy

<Note>
  Jednotlivé endpointy — s parametry, těly požadavků a příklady — najdete v postranním panelu této sekce. Jsou generovány přímo z OpenAPI specifikace.
</Note>