REST API vs SMPP: kdy který použít na SMS
Praktické srovnání HTTP REST a SMPP protokolu. Latence, propustnost, integrace. Doporučení podle objemu a use case.
REST API i SMPP umějí to samé — odeslat SMS. Ale každý je vhodný pro jiný typ aplikace. Tento článek vysvětluje rozdíly a kdy zvolit který.
REST API — moderní HTTP přístup
REST API znamená posílat SMS přes obyčejné HTTPS volání. Tak to vypadá v TypeScriptu:
const res = await fetch('https://www.topsms.cz/api/sms/send', {
method: 'POST',
headers: {
'Authorization': `Bearer ${CLIENT_ID}:${CLIENT_SECRET}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
to: '+420608030884',
text: 'Vaše objednávka 12345 byla expedována.',
}),
})
Výhody:
- Snadná integrace — každý jazyk umí HTTP, žádné speciální knihovny nepotřebujete
- Stateless — žádné permanentní spojení k udržování
- Firewall friendly — port 443, jako každý web
- Auto-retry je triviální — vaše aplikace zopakuje request při timeout
- Logging out of the box — všechno vidíte v access logu
Nevýhody:
- Latence ~200-500 ms per request (HTTP roundtrip + auth + queueing)
- Propustnost limitována — typicky 50-200 SMS/sekundu na 1 connection
- Overhead — každá SMS = nový HTTP request s headers
SMPP — průmyslový SMS protokol
SMPP (Short Message Peer-to-Peer) je binární protokol navržený speciálně pro SMS. Funguje na permanentním TCP spojení mezi vaší aplikací a SMSC operátora.
Výhody:
- Velmi nízká latence — typicky 50-150 ms per SMS
- Vyšší propustnost než REST API — díky perzistentnímu spojení bez HTTP overhead na každou zprávu
- Real-time delivery reporty — server tlačí stav doručení okamžitě, bez polling (podobně jako webhooky u REST API)
- Binární protokol — efektivní bandwidth (kratší pakety než JSON)
- Žádný overhead per zpráva — auth jednou, posíláte ad libitum
Nevýhody:
- Komplexnější — potřebujete SMPP knihovnu (PHP: smpp/smpp, Node: smpp, Python: jasmin-sms)
- Persistentní spojení — musíte řešit reconnect, heartbeat, bind sessions
- Firewall — typicky port 2775, někdy 8775 — IT musí povolit
- Stavová — pokud spojení padne, ztrácíte queue
Decision matrix
| Use case | Doporučený protokol | Důvod |
|---|---|---|
| E-shop notifikace (objednávka, doručení) | REST API | Nízký objem (10-1000/den), jednoduchá integrace |
| OTP / 2FA | REST API | Latence 200-500ms je akceptovatelná, vyšší propustnost není třeba |
| Hromadné kampaně, velké objemy | SMPP (individuálně od 20 000 SMS/měsíc) | Propustnost rozhoduje; REST API funguje, ale pomaleji |
| Velkoobchod s velmi vysokým objemem | SMPP (na vyžádání) | Latence + propustnost — REST by saturoval HTTP overhead |
| Banky / OTP s přísnými nároky na rychlost | SMPP | Nižší latence než REST API |
| Notifikační systém (logistika, healthcare) | REST API | Pro většinu use cases stačí |
| Interní firemní systém (Pohoda, Helios) | REST API | CSV export nebo REST API integrace |
Orientační srovnání
| Metrika | REST API | SMPP |
|---|---|---|
| Latence (send → SMSC) | 200-400 ms | 50-150 ms |
| Max throughput / connection | nižší (HTTP overhead na request) | vyšší (perzistentní spojení) |
| Delivery reporty | Polling (status endpoint) nebo webhook | Real-time (binary) |
| Připojení | HTTPS, stateless | TCP port 2775, persistent |
| Knihovny | curl, fetch, axios | smpp-node, kannel, jsmpp |
| Implementace | 1 hodina | 1-2 dny (první integrace) |
Hybridní přístup
V praxi není volba "buď REST nebo SMPP" exkluzivní. Mnoho velkých firem používá obojí:
- REST API pro běžné notifikace (objednávky, OTP)
- SMPP pro nárazy (kampaně, peak hours)
V TopSMS je standardem REST API; SMPP připojení řešíme individuálně pro velkoobjemové klienty. Začněte s REST a ozvěte se nám, až vám přestane stačit.
Doporučení podle objemu
- < 20 000 SMS/měsíc → REST API stačí, o SMPP není důvod uvažovat
- 20 000 - 100 000 SMS/měsíc → REST API obvykle stačí; od 20 000 SMS měsíčně lze individuálně domluvit i SMPP připojení
- > 100 000 SMS/měsíc → má smysl probrat individuální SMPP připojení, konkrétní přínos záleží na způsobu odesílání
Začněte s REST
Naprostá většina klientů začíná s REST API a nikdy nepotřebuje přejít na SMPP. Integrace zabere hodinu, knihovny existují pro každý jazyk:
- PHP — Guzzle / cURL
- Python — requests
- Node.js — axios / fetch
- Java — OkHttp / RestTemplate
- Go — net/http
- C# — HttpClient
Pluginy pro WooCommerce, Shoptet a PrestaShop se připravují; zatím nejrychlejší cestou je REST API. Pro Pohodu a další ERP slouží CSV export nebo REST API integrace.
Dokumentace: REST API · SMPP · Pluginy
V dalším článku: jak SMS šetří hodiny v call centru — 5 konkrétních use cases s ROI čísly.