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:
|
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:
|
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
|
