Přístup na https://api.mailservis.cz?key=. Klíč je pro každého klienta unikátní, zobrazen je po přihlášení do klientské sekce na mailservis.cz/klient

Api umožňuje jednorázové založení distribuce sms

https://api.mailservis.cz/set/sms?key=XXX
        

Obsah Textový obsah SMS zprávy. Bude automaticky očištěn o dikaritiku, optimální délka je

Příjemce Telefoní číslo ve formátu bez předvolby "606132456" nebo s předvolbou "+42006123456"

Distribuce Založená rozesíla – kombinace obsahu a výběru příjemců.

Vzor php kódu pro volání API:

V příkladu se posílá zpráva na seznam telefoních čísel, zprávu odesíláme hned a na všechna čísla stejnou.

Kompletní specifikaci a celý výčet parametrů naleznete níže!

<?php

$apikey = "demo_7p4H6ydGi36MkpWUbr50";

//priprava dat pro api
$data = array(
    "sendtime" => date("Y-m-d H:00"),
    "title" => "Interní název rozesílky",
    "content" => "Jen dnes máme slevu na 30% na všechny produkty"
    "phones" => array(
            "606000001", "606000002", "606000003"
    ),
);

//volani api
$tmp = file_get_contents("https://api.mailservis.cz/set/sms/?key={$apikey}&data=".urlencode(json_encode($data)));

//vysledek
var_dump($tmp);
        

Vzor php kódu pro volání API:

V tomto příkladu se na každé telefoní číslo jiná zpráva.

Kompletní specifikaci a celý výčet parametrů naleznete níže!

<?php

$apikey = "demo_7p4H6ydGi36MkpWUbr50";

//priprava dat pro api
$data = array(
    "sendtime" => date("Y-m-d H:00"),
    "title" => "Interní název rozesílky",
    "messages" => array(
        array("phone" => "606000001",  "content" => "Objednavka 54850 je připravena k vyzvednuti."),
        array("phone" => "606000002",  "content" => "Objednavka 54851 je připravena k vyzvednuti, zaplatite 128 Kc."),
        array("phone" => "606000003",  "content" => "Objednavka 54852 byla předana přepravci."),
    ),
);

//volani api
$tmp = file_get_contents("https://api.mailservis.cz/set/sms/?key={$apikey}&data=".urlencode(json_encode($data)));

//vysledek
var_dump($tmp);
        

Vysvětlení všech možných paramterů:

sendtime - čas kdy má začít rozesílání. To je omezeno na 600 zpráv za hodinu
title - interní název rozesílky který bude zobrazen v aplikaci MAILservis. Tento název příjemce neuvidí.
content - obsah sms, pokud má být pro všechna telefoní čísla stejný
phones - pole telefoních čísel pokud mají všichni obdržet stejný obsah sms
messages - pole příjemců a sms určené konkrétnímu telefonímu číslo, viz vzor #2