REST API — Referenční příručka správy účtu a zpráv

SmsManager REST API pro správu účtu: správa API klíčů a podřízených klíčů, práce s kreditem a fakturací, sledování stavu zpráv, čtení přijatých zpráv, správa blacklistu a opt-out seznamů, hromadné odesílání a integrace partnerských platforem.

SmsManager REST API je samostatné API oddělené od JSON API v2 (odesílací API). Zatímco JSON API v2 zpracovává doručování odchozích zpráv, REST API pokrývá vše kolem vašeho účtu. Můžete vytvářet a spravovat API klíče (včetně podřízených klíčů), pracovat s kreditem — procházet katalog služeb a ceník, nastavovat upozornění na nízký kredit a objednávat nebo rušit placené služby — a řešit fakturaci, od fakturačního kontaktu a faktur (včetně stahování PDF) až po dobití bankovním převodem. Dále umožňuje sledovat stav zpráv a statistiky odesílání, číst příchozí zprávy ve vaší schránce, spravovat blacklist a opt-out seznamy, spouštět hromadné odesílání a propojovat partnerské účty a platformové integrace.

Základní URL

Všechny požadavky REST API se provádějí na:

https://rest-api.smsmngr.com/v1

Autentizace

Každý požadavek musí obsahovat váš API klíč v hlavičce požadavku x-api-key. Je to stejný API klíč, který používáte s JSON API v2.

x-api-key: YOUR_API_KEY

Své API klíče můžete najít a spravovat v SmsManager Dashboardu.

Endpointy

API klíče

Metoda	Endpoint	Popis
GET	/apikey/me	Získat informace o aktuálním API klíči
POST	/apikey/add	Vytvořit podřízený API klíč
POST	/apikey/update	Upravit aktuální API klíč
GET	/apikey/list	Vypsat podřízené API klíče
POST	/apikey/change	Změnit podřízený API klíč

Kredit

Metoda	Endpoint	Popis
GET	/credit	Získat stav kreditu
GET	/credit/services	Získat katalog služeb
GET	/credit/prices	Získat ceník
GET	/credit/notify	Získat nastavení upozornění na nízký kredit
POST	/credit/notify	Nastavit upozornění na nízký kredit
POST	/credit/order	Objednat placenou službu
POST	/credit/cancel	Zrušit placenou službu

Fakturace

Metoda	Endpoint	Popis
POST	/billing/get	Získat fakturační kontakt
POST	/billing/set	Nastavit fakturační kontakt
POST	/billing/invoices/list	Vypsat faktury
POST	/billing/invoices/pdf	Stáhnout fakturu v PDF
GET	/billing/topup	Získat údaje pro dobití bankovním převodem

Stav zpráv

Metoda	Endpoint	Popis
GET	/message	Získat stav zprávy
GET	/messages	Vypsat odeslané zprávy podle data
GET	/request	Získat statistiky požadavku
GET	/requests	Získat agregované statistiky podle data

Přijaté zprávy

Metoda	Endpoint	Popis
GET	/inbox	Získat přijaté zprávy podle data

Blacklist a opt-out

Metoda	Endpoint	Popis
GET	/blacklist	Stáhnout blacklist
POST	/blacklist	Přidat čísla na blacklist
DELETE	/blacklist	Odebrat čísla z blacklistu
GET	/optout	Stáhnout opt-out seznam
POST	/optout	Přidat čísla na opt-out seznam
DELETE	/optout	Odebrat čísla z opt-out seznamu

Hromadné odesílání

Nahrajte JSONL soubor s tisíci zpráv přes předpodepsanou URL místo tisíců volání odesílacího API. Celý postup najdete v průvodci Hromadné odesílání.

Metoda	Endpoint	Popis
POST	/messaging/url	Získat URL pro hromadné nahrání
POST	/messaging/cancel	Zrušit naplánovanou zprávu nebo hromadné nahrání

Partneři a integrace

Tyto endpointy jsou určené pro partnerské účty a platformové integrace — partnerská registrace, registrace push zařízení, registrace příjemce a akce konektorů třetích stran (například Klaviyo).

Metoda	Endpoint	Popis
POST	/partner/signup	Zahájit partnerskou registraci
POST	/push/device	Registrovat push zařízení
POST	/recipient/register	Registrovat příjemce
POST	/connect/{connector}/{action}	Akce konektoru

Pro AI agenty

Stav zpráv, schránku, opt-out seznamy, objednávání služeb i hromadné nahrávání pokrývají skills smsmanager-message-status, smsmanager-optout-blacklist, smsmanager-services a smsmanager-bulk-messaging z balíčku SmsManager skills. Správu klíčů, kreditu, fakturace a služeb zvládne AI asistent i přímo přes MCP server s OAuth přihlášením.

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.