HTTP XML Post

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