HTTP XML Post

2010.07.28 00:29:55

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


* Dubliuojantys numeriai yra filtruojami sms4you 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>long</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 id sms4you sistemoje

password

Kliento slaptažodis sms4you 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, kuris 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 atsakyma 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 id arba slaptažodis

XML_ERROR

-2

Neteisingas XML formatas

NOT_ENOUGH_CREDITS

-3

Nepakanka pinigų kliento sąskaitoje

NO_RECIPIENTS

-4

Nėra tinkamų gavėjų

SEND_OK

>0

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