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

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:

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. 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í.

​

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.

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.

​

Prozkoumejte endpointy

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.