Úvod

InfoSMS.online poskytuje jednoduché REST API pre odosielanie a príjem SMS správ. API podporuje JSON aj XML formát a je kompatibilné so štandardom SMSGateway.

Base URL

https://infosms.online

Podporované formáty

• JSON — preferovaný formát, header Content-Type: application/json
• XML — kompatibilita so staršími integráciami
• form-data — pre jednoduché POST požiadavky

Autentifikácia

InfoSMS.online rozlišuje dva typy API kľúčov podľa účelu:

1. Sender API kľúč (akey) — pre SMS Brána a jednoduchý SIM Hosting

Priraďuje sa ku konkrétnemu odosielateľovi alebo SIM karte. Nájdete ho v administrácii pri konkrétnom SIM konte (mdl_user.akey). Používa sa s parametrami username + password (alebo namiesto hesla priamo akey ak má viac ako 30 znakov).

2. Účtový API kľúč (account_akey) — pre reseller multi-sender bulk

Patrí celému klientskému účtu (nie jednej SIM karte). Nájdete ho v portáli v sekcii 🔑 API kľúč. Umožňuje posielať hromadné SMS cez API — každej správe môžete zvoliť vlastného sendera. Používa sa s parametrami username + account_akey.

Formát požiadaviek

API akceptuje požiadavky v JSON alebo XML formáte. Odpovede sú vrátené v rovnakom formáte ako požiadavka.

Telefónne čísla

Číslo príjemcu (to) vyžadujeme striktne v medzinárodnom formáte s predvoľbou, vrátane znaku +:

Iné formáty (bez znaku +, národné tvary typu 0905123456 alebo 905123456) API neakceptuje — požiadavka s takýmto číslom bude odmietnutá s chybou INVALID_NUMBER.

Kódovanie správ

Predvolene sa diakritika automaticky normalizuje (á→a, č→c...). Pre unicode SMS nastavte parameter unicode=1 — cena sa počíta podľa unicode limitu (70 znakov/SMS).

Chybové kódy

Endpointy SMS brány (/api/bulk/, /api/sim/send.php, /api/balance/, /api/account/...) vracajú chyby v jednotnom tvare {"status":"ERR"|"ERROR","msg"|"message":"popis chyby"} (resp. ekvivalentný XML element <status>ERR</status>). HTTP stavový kód 200 sa vracia aj pri čiastočnom zlyhaní v rámci hromadného odoslania (pozri pole errors).

Odoslanie SMS

Odošle SMS jednému alebo viacerým príjemcom. Endpoint je rovnaký pre jednu SMS aj pre hromadné odoslanie — rozdiel je len v počte čísel v poli numbers (pre jednu SMS stačí pole s jedným číslom).

Parametre

Príklad požiadavky (jedna SMS)

POST /api/bulk/
Content-Type: application/json

{
  "user":    "vas@email.sk",
  "pass":    "vas-api-kluc",
  "numbers": [{ "number": "+421905123456", "msgid": "objednavka-1234" }],
  "text":    "Vaša objednávka č. 1234 je pripravená na vyzdvihnutie.",
  "from":    "MojaFirma"
}

POST /api/bulk/
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<request>
  <credential>
    <user>vas@email.sk</user>
    <pass>vas-api-kluc</pass>
  </credential>
  <message>
    <text>Vasa objednavka c. 1234 je pripravena na vyzdvihnutie.</text>
    <from>MojaFirma</from>
    <numbers>
      <number msgid="objednavka-1234">+421905123456</number>
    </numbers>
  </message>
</request>

Odpoveď (úspech)

{
  "status":  "OK",
  "sent":    1,
  "failed":  0,
  "credit":  4.2350,
  "results": [
    { "number": "+421905123456", "msgid": "objednavka-1234" }
  ]
}

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>OK</status>
  <sent>1</sent>
  <failed>0</failed>
  <credit>4.2350</credit>
  <results>
    <result><number>+421905123456</number><msgid>objednavka-1234</msgid></result>
  </results>
</response>

Pre odoslanie viacerým príjemcom naraz (max 1000 čísel) a popis čiastočného zlyhania pozri sekciu Hromadné odoslanie.

Hromadné odoslanie

Odošle rovnakú správu na viac čísel naraz. Maximálne 1000 čísel na jednu požiadavku.

Parametre

Príklad požiadavky

POST /api/bulk/
Content-Type: application/json

{
  "user":    "vas@email.sk",
  "pass":    "vas-api-kluc",
  "numbers": [
    { "number": "+421905111111", "msgid": "klient-1001" },
    { "number": "+421905222222", "msgid": "klient-1002" },
    "+421905333333"
  ],
  "text":    "Akcia: -30% na všetky produkty do konca týždňa!",
  "from":    "MojaFirma"
}

POST /api/bulk/
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<request>
  <credential>
    <user>vas@email.sk</user>
    <pass>vas-api-kluc</pass>
  </credential>
  <message>
    <text>Akcia: -30% na vsetky produkty do konca tyzdna!</text>
    <from>MojaFirma</from>
    <numbers>
      <number msgid="klient-1001">+421905111111</number>
      <number msgid="klient-1002">+421905222222</number>
      <number>+421905333333</number>
    </numbers>
  </message>
</request>

Odpoveď (úspech)

{
  "status":  "OK",
  "sent":    3,
  "failed":  0,
  "credit":  3.9850,
  "results": [
    { "number": "+421905111111", "msgid": "klient-1001" },
    { "number": "+421905222222", "msgid": "klient-1002" },
    { "number": "+421905333333", "msgid": "11087" }
  ]
}

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>OK</status>
  <sent>3</sent>
  <failed>0</failed>
  <credit>3.9850</credit>
  <results>
    <result><number>+421905111111</number><msgid>klient-1001</msgid></result>
    <result><number>+421905222222</number><msgid>klient-1002</msgid></result>
    <result><number>+421905333333</number><msgid>11087</msgid></result>
  </results>
</response>

Odpoveď (čiastočné zlyhanie)

Ak je niektoré číslo neplatné alebo sa správu nepodarí odoslať, v odpovedi pribudne pole errors s dôvodom pre každé zlyhané číslo — ostatné čísla v dávke sa odošlú normálne.

{
  "status":  "OK",
  "sent":    2,
  "failed":  1,
  "credit":  3.9850,
  "errors": [
    { "number": "+421900111222", "msg": "Neplatné telefónne číslo: +421900111222" }
  ]
}

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>OK</status>
  <sent>2</sent>
  <failed>1</failed>
  <credit>3.9850</credit>
  <errors>
    <error><number>+421900111222</number><msg>Neplatné telefónne číslo: +421900111222</msg></error>
  </errors>
</response>

Stav doručenia

Vráti aktuálny stav doručenia SMS podľa msgid — hodnoty z poľa results[].msgid v odpovedi Odoslanie SMS / Hromadné odoslanie (vlastné ID, ktoré ste poslali, alebo naše vygenerované).

Parametre

Príklad požiadavky

GET /api/status/?user=vas@email.sk&pass=vas-api-kluc&msgid=objednavka-1234

Odpoveď (úspech)

{
  "status":          "OK",
  "msgid":           "objednavka-1234",
  "delivery_status": "delivered",
  "number":          "421905123456",
  "sent_at":         "2026-06-07T14:30:00+02:00",
  "delivered_at":    "2026-06-07 14:32:10"
}

Odpoveď (nenájdené)

{
  "status": "ERR",
  "msg":    "Správa s daným msgid nebola nájdená."
}

Zostatok kreditu

Vráti aktuálny dostupný kredit na vašom účte. Parameter user je prihlasovací email, pass je účtový API kľúč (account_akey, sekcia 🔑 API kľúč v portáli).

{
  "status":  "OK",
  "balance": 12.4500,
  "currency":"EUR"
}

Odoslanie cez SIM Hosting

Odošle SMS priamo cez vašu SIM kartu. Správa musí byť bez diakritiky (automaticky normalizovaná). Vyžaduje aktívny SIM Hosting účet.

Endpoint prijíma JSON aj form-data (application/x-www-form-urlencoded).

Príklad požiadavky

POST /api/sim/send.php
Content-Type: application/json

{
  "user": "vas@email.sk",
  "pass": "vas-api-kluc",
  "to":   "+421905123456",
  "text": "Dobry den, vasa objednavka je pripravena."
}

Odpoveď (úspech)

{
  "status": "OK",
  "idsms": 12345
}

Odpoveď (chyba)

{
  "status": "ERR",
  "msg":    "Nedostatok kreditu. Zostatok: 0.0000 EUR"
}

Prijaté SMS (SIM)

SMS prijaté na vašu SIM kartu (server transmitter, self_hosted=0) sa nedajú vyzdvihnúť pollingom — server vám každú prijatú SMS okamžite odošle formou webhooku na callback URL nastavenú pri danej SIM karte (parameter curl, pozri sekciu SIM Management API). Technický popis nájdete v sekcii Webhook.

Webhook

Callback URL sa nastavuje per SIM karta cez parameter curl v SIM Management API (/api/account/sim.php, pozri sekciu SIM Management — update). Server na túto URL odošle GET požiadavku s query parametrami pri dvoch typoch udalostí, rozlíšených parametrom event:

Príklad — prijatá SMS

GET https://vas-server.sk/callback?event=incoming&id=1042&from=%2B421905999888&sim=%2B421000000000&text=Ahoj%2C+aky+je+termin+dodania%3F&received_at=2026-06-07+09%3A14%3A22

Príklad — stav doručenia

GET https://vas-server.sk/callback?event=delivery&idsms=12345&status=delivered&number=%2B421905123456&gw_id=...

Hromadný multi-sender (Reseller)

Odošle hromadné SMS cez SIM Hosting pričom každá správa môže mať vlastného odosielateľa (SIM kartu). Určené pre resellerov, ktorí prevádzkujú viacero SIM kariet pod jedným účtom. Autentifikácia prebieha cez účtový API kľúč (account_akey) — jeden kľúč pre celý účet, bez potreby prepínať medzi sender kľúčmi.

Parametre požiadavky

Parametre každej správy (messages[])

Príklad požiadavky

POST /api/account/bulk-send.php
Content-Type: application/json

{
  "username":     "vas@email.sk",
  "account_akey": "vas-uctovy-api-kluc",
  "messages": [
    {
      "recipient": "+421900111222",
      "sender":    "421947932736",
      "message":   "Dobry den, vasa objednavka je pripravena."
    },
    {
      "recipient": "+421900333444",
      "sender":    "421948700708",
      "message":   "Upomienka: termin stretnutia zajtra o 10:00."
    },
    {
      "recipient": "+421900555666",
      "message":   "Tato sprava ide cez predvoleneho sendera."
    }
  ]
}

POST /api/account/bulk-send.php
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<request>
  <credential>
    <username>vas@email.sk</username>
    <account_akey>vas-uctovy-api-kluc</account_akey>
  </credential>
  <messages>
    <message>
      <recipient>+421900111222</recipient>
      <sender>421947932736</sender>
      <text>Dobry den, vasa objednavka je pripravena.</text>
    </message>
    <message>
      <recipient>+421900333444</recipient>
      <sender>421948700708</sender>
      <text>Upomienka: termin stretnutia zajtra o 10:00.</text>
    </message>
  </messages>
</request>

Odpoveď (úspech)

{
  "status":  "OK",
  "sent":    2,
  "failed":  1,
  "results": [
    { "recipient": "+421900111222", "sender": "421947932736", "status": "OK",  "idsms": 12345 },
    { "recipient": "+421900333444", "sender": "421948700708", "status": "OK",  "idsms": 12346 },
    { "recipient": "+421900555666", "sender": "421947932736", "status": "ERR", "msg": "Nedostatok kreditu" }
  ]
}

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>OK</status>
  <sent>2</sent>
  <failed>1</failed>
  <results>
    <result><recipient>+421900111222</recipient><sender>421947932736</sender><status>OK</status><idsms>12345</idsms></result>
    <result><recipient>+421900333444</recipient><sender>421948700708</sender><status>OK</status><idsms>12346</idsms></result>
    <result><recipient>+421900555666</recipient><sender>421947932736</sender><status>ERR</status><msg>Nedostatok kreditu</msg></result>
  </results>
</response>

SIM Management API (Reseller)

Programová správa SIM kont — vytváranie, zobrazovanie, úprava a mazanie. Určené pre resellerov, ktorí distribuujú SIM karty vlastným klientom a potrebujú tento proces automatizovať. Bez limitu počtu SIM kont (limit 10 platí len pre samoregistráciu z portálu).

Prehľad akcií

Spoločné parametre každého requestu

SIM Management — list

Vráti zoznam všetkých SIM kont priradených k účtu, vrátane ich akey (potrebné pre nastavenie Android appky).

{
  "username":     "vas@email.sk",
  "account_akey": "vas-uctovy-api-kluc",
  "action":       "list"
}

<?xml version="1.0" encoding="UTF-8"?>
<request>
  <credential>
    <username>vas@email.sk</username>
    <account_akey>vas-uctovy-api-kluc</account_akey>
  </credential>
  <action>list</action>
</request>

{
  "status": "OK",
  "count":  2,
  "sims": [
    { "id": 41, "myphone": "421947932736", "sim_price": 0.008, "active": 1, "self_hosted": 1, "akey": "a1b2c3..." },
    { "id": 42, "myphone": "421948700708", "sim_price": 0.010, "active": 1, "self_hosted": 0, "akey": "d4e5f6..." }
  ]
}

SIM Management — create

Vytvorí jedno alebo viacero SIM kont naraz. Pre každé úspešne vytvorené konto vráti vygenerovaný akey — ten je potrebné zadať do Android appky.

Parametre každého záznamu v sims[]

{
  "username":     "vas@email.sk",
  "account_akey": "vas-uctovy-api-kluc",
  "action":       "create",
  "sims": [
    {
      "myphone":    "421900111222",
      "self_hosted": 1,
      "sim_price":  0.008
    },
    {
      "myphone":       "421900333444",
      "self_hosted":   0,
      "sim_price":     0.010,
      "contact_email": "klient@example.sk",
      "curl":          "https://vas-server.sk/callback"
    }
  ]
}

<?xml version="1.0" encoding="UTF-8"?>
<request>
  <credential>
    <username>vas@email.sk</username>
    <account_akey>vas-uctovy-api-kluc</account_akey>
  </credential>
  <action>create</action>
  <sims>
    <sim>
      <myphone>421900111222</myphone>
      <self_hosted>1</self_hosted>
      <sim_price>0.008</sim_price>
    </sim>
    <sim>
      <myphone>421900333444</myphone>
      <self_hosted>0</self_hosted>
      <sim_price>0.010</sim_price>
      <curl>https://vas-server.sk/callback</curl>
    </sim>
  </sims>
</request>

{
  "status":  "OK",
  "created": 2,
  "failed":  0,
  "results": [
    { "myphone": "421900111222", "status": "OK", "id": 42, "akey": "a1b2c3d4...", "self_hosted": 1, "sim_price": 0.008, "active": 1 },
    { "myphone": "421900333444", "status": "OK", "id": 43, "akey": "e5f6g7h8...", "self_hosted": 0, "sim_price": 0.010, "active": 1 }
  ]
}

SIM Management — update

Zmení údaje existujúceho SIM konta. Stačí poslať len polia, ktoré chcete zmeniť — ostatné zostanú nezmenené.

{
  "username":     "vas@email.sk",
  "account_akey": "vas-uctovy-api-kluc",
  "action":       "update",
  "sim_id":       42,
  "active":       0,
  "sim_price":    0.012
}

<?xml version="1.0" encoding="UTF-8"?>
<request>
  <credential>
    <username>vas@email.sk</username>
    <account_akey>vas-uctovy-api-kluc</account_akey>
  </credential>
  <action>update</action>
  <sim_id>42</sim_id>
  <active>0</active>
  <sim_price>0.012</sim_price>
</request>

{
  "status":      "OK",
  "id":          42,
  "myphone":     "421900111222",
  "sim_price":   0.012,
  "active":      0,
  "self_hosted": 1
}

SIM Management — delete

Natrvalo zmaže SIM konto. Táto akcia je nevratná.

{
  "username":     "vas@email.sk",
  "account_akey": "vas-uctovy-api-kluc",
  "action":       "delete",
  "sim_id":       42
}

<?xml version="1.0" encoding="UTF-8"?>
<request>
  <credential>
    <username>vas@email.sk</username>
    <account_akey>vas-uctovy-api-kluc</account_akey>
  </credential>
  <action>delete</action>
  <sim_id>42</sim_id>
</request>

{
  "status":     "OK",
  "deleted_id": 42,
  "myphone":    "421900111222"
}

Príklad: PHP

SMS Brána — jedna SMS

<?php
$ch = curl_init('https://infosms.online/api/bulk/');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode([
        'user'    => 'vas@email.sk',
        'pass'    => 'vas-api-kluc',
        'numbers' => ['+421905123456'],
        'text'    => 'Vasa objednavka je pripravena.',
        'from'    => 'MojaFirma',
    ]),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $result['status'] === 'OK' ? "Odoslaných: {$result['sent']}" : $result['msg'];

Reseller — SIM Management (create + list)

<?php
function simApi($action, $payload) {
    $ch = curl_init('https://infosms.online/api/account/sim.php');
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => json_encode(array_merge([
            'username'     => 'vas@email.sk',
            'account_akey' => 'vas-uctovy-api-kluc',
            'action'       => $action,
        ], $payload)),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    ]);
    $r = json_decode(curl_exec($ch), true);
    curl_close($ch);
    return $r;
}

// Vytvorenie dvoch SIM kont
$res = simApi('create', [
    'sims' => [
        ['myphone' => '421900111222', 'self_hosted' => 1],
        ['myphone' => '421900333444', 'self_hosted' => 1],
    ]
]);
foreach ($res['results'] as $s) {
    echo "{$s['myphone']} — akey: {$s['akey']}\n";
}

// Zoznam všetkých SIM kont
$list = simApi('list', []);
foreach ($list['sims'] as $s) {
    echo "{$s['myphone']} — active: {$s['active']}\n";
}

Reseller — hromadné multi-sender cez SIM Hosting

<?php
$ch = curl_init('https://infosms.online/api/account/bulk-send.php');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode([
        'username'     => 'vas@email.sk',
        'account_akey' => 'vas-uctovy-api-kluc',
        'messages'     => [
            ['recipient' => '+421900111222', 'sender' => '421947932736', 'message' => 'Text pre prveho.'],
            ['recipient' => '+421900333444', 'sender' => '421948700708', 'message' => 'Text pre druheho.'],
        ],
    ]),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
echo "Odoslaných: {$result['sent']}, chýb: {$result['failed']}";

Príklad: Python

import requests

# Odoslanie SMS cez InfoSMS.online API

url  = 'https://infosms.online/api/bulk/'
data = {
    'user':    'vas@email.sk',
    'pass':    'vas-api-kluc',
    'numbers': ['+421905123456'],
    'text':    'Vaša objednávka je pripravená.',
    'from':    'MojaFirma',
}

response = requests.post(url, json=data)
result   = response.json()

if result['status'] == 'OK':
    print(f"Odoslaných: {result['sent']}, zostatok: {result['credit']}")
else:
    print(f"Chyba: {result['msg']}")

Príklad: cURL

# Odoslanie SMS (SMS Brána)
curl -X POST https://infosms.online/api/bulk/ \
  -H "Content-Type: application/json" \
  -d '{"user":"vas@email.sk","pass":"vas-api-kluc","numbers":["+421905123456"],"text":"Test SMS","from":"MojaFirma"}'

# Reseller — hromadné multi-sender (JSON)
curl -X POST https://infosms.online/api/account/bulk-send.php \
  -H "Content-Type: application/json" \
  -d '{
    "username":     "vas@email.sk",
    "account_akey": "vas-uctovy-api-kluc",
    "messages": [
      {"recipient":"+421900111222","sender":"421947932736","message":"Text 1"},
      {"recipient":"+421900333444","sender":"421948700708","message":"Text 2"}
    ]
  }'

# Reseller — hromadné multi-sender (XML)
curl -X POST https://infosms.online/api/account/bulk-send.php \
  -H "Content-Type: application/xml" \
  -d '<?xml version="1.0"?><request><credential><username>vas@email.sk</username><account_akey>vas-uctovy-api-kluc</account_akey></credential><messages><message><recipient>+421900111222</recipient><sender>421947932736</sender><text>Text 1</text></message></messages></request>'

# Zostatok kreditu
curl "https://infosms.online/api/balance/?user=vas@email.sk&pass=vas-api-kluc"

Príklad: Node.js

// Odoslanie SMS cez InfoSMS.online API
// npm install node-fetch

import fetch from 'node-fetch';

const url  = 'https://infosms.online/api/bulk/';
const data = {
  user:    'vas@email.sk',
  pass:    'vas-api-kluc',
  numbers: ['+421905123456'],
  text:    'Vaša objednávka je pripravená.',
  from:    'MojaFirma',
};

const res    = await fetch(url, {
  method:  'POST',
  headers: { 'Content-Type': 'application/json' },
  body:    JSON.stringify(data),
});
const result = await res.json();

if (result.status === 'OK') {
  console.log(`Odoslaných: ${result.sent}, zostatok: ${result.credit}`);
} else {
  console.error(`Chyba: ${result.msg}`);
}