HTTP XML Post

2009.07.23 12:47:54 / 2011.03.19 15:23:42

Interneto adresas (URL) į kurį siunčiami XML formato duomenys:
https://service.sms4you.lt/XMLInput.php


* Dubliuojantys numeriai yra filtruojami SMSpunktas.lt sistemoje (vienas gavėjas gali gauti tik vieną žinutę per vieną užklausą).

XML formatas

XML formato simbolių seka turi būti išsiųsta XML rakto pavadinimu; "XML" => "<SMS>.</SMS>"

<SMS>
    <authentification>
        <username></username>
        <password></password>
    </authentification>
    <message>
        <sender></sender>
        <text></text>
        <type>longsms</type>
    </message>
    <recipients>
        <gsm messageId="clientmsgID1"></gsm>
        <gsm messageId="clientmsgID2"></gsm>
        <gsm messageId="clientmsgID3"></gsm>
        <gsm messageId="clientmsgID4"></gsm>
    </recipients>
</SMS>

Oranžinės spalvos tekstas žymi nebūtinus parametrus.

Parametrų specifikacija:

Parametras

Aprašymas

authentification

username

Kliento el. paštas SMSpunktas.lt sistemoje

password

Kliento slaptažodis SMSpunktas.lt sistemoje

message

sender

Dinaminis žinutės siuntėjo ID; galimos raidinės ir skaitmeninės simbolių sekos. Ilgis iki 11 arba tik skaitmeninės iki 14 simbolių

text

Žinutės tekstas

type Nustačius šį parametrą, ilga žinutė (daugiau negu 160 simbolių)  bus pistatyta adresatui kaip viena žinutė.

recipients

gsm

Gavėjo adresas privalo būti tarptautiniu formatu. Pradžioje negali būti "0" ar "+". Pavyzdys: 37065841316

messageId

Registruotas pristatymas; klientas nurodo žinutės ID, kuris yra reikalingas gauti informacijai apie žinutės pristatymą

Grąžinami XML duomenys

Po POST XML užklausos, klientas gauna atsakymą iš serverio XML formatu.

XML formatas

<RESPONSE>
    <status>status_code</status>
    <credits>credit_amount</credits>
</RESPONSE>

Status reikšmės ir aprašymai:

Status

Reikšmė

Aprašymas

AUTH_FAILED

-1

Neteisingas vartotojo el. paštas arba slaptažodis

XML_ERROR

-2

Neteisingas XML formatas

NOT_ENOUGH_CREDITS

-3

Vartotojo sąskaitoje nepakanka pinigų

NO_RECIPIENTS

-4

Nėra tinkamų gavėjų

SEND_OK

>0

Žinučių skaičius, kuris bus išsiųstas

 
Danske BankasDNB NordNordeaCitadele BankasSEBSwedbankŠiaulių BankasŪkio BankasParduotuvė MaximaKioskai Lietuvos Spauda ir RkioskFOXBOX automataiMokėjimas grynais bankePayPalVisaVisa ElectronMasterCardDiners ClubJCBMoneybookersAmerican Express