English | Slovak

smsSendBillXML

Description
Sending billed message with POST method
Functionality


All requests are sent to URL listed below. Message body format have to be kept for sending of message succesfuly.
In case of success send the HTTP response 200 is returned and the answer is in the body. In case of error, the error HTTP response is returned back with the error description
Request
POST http://text421.naimar.sk/api/v6/rest/billsms/xml
Body
<sms>
   <username>test</username>
   <password>test</password>
   <billing>
      <billkey>1234</billkey>
      <from>7401</from>
   </billing>  
   <message>
      <text>Test SMS</text>
   </message>
   <recipients>
      <recipient>
         <id>123456</id>
         <rcv_msg_id>25481978</rcv_msg_id>
         <msisdn>421901727051</msisdn>
      </recipient>
      <recipient>
         <id>789412</id>
         <rcv_msg_id>25481979</rcv_msg_id>
         <msisdn>421901727053</msisdn>
      </recipient>
   </recipients>
</sms>        
Parameter Required Type Description
username
required Varchar (16) user name
password
required varchar (16) password
Billing
billkey
required varchar billing key
from
required integer short numbter
Message
text
required text Text of message. Standard text message - 160 characters, binary SMS - 280 characters
type
optional binary binary - binary message
dcs
optional integer if DCS is missing and message is binary, standard DCS 245 is used
esm
optional integer if ESM is missing and message is binary, standard ESM 64 is used
delivery
optional timestamp non mandatory parameter, time when message is sent (example 2012-11-05 16:01:22)
Recipients
id
required varchar (14) unique message ID
rcv_msg_id
required integer unique ID from incoming message
msisdn
required integer number where message will be sent
Response
Parameter Type Description
status integer server response (200 if API receive the message, 4xx in case of error)
description varchar (300) detailed error description
recipients integer number of received MSISDN
Error response
Chybové návratové hodnoty
Error ID Description Detail
400 unknown prefix xxx unknown prefix, use known prefix like 901, 903, ...
400 unknown network xxx you can't send SMS to this network
400 missing incoming msg missing incoming message with this rcv_msg_id
400 missing parameter rcv_msg_id missing mandatory parameter rcv_msg_id
400 missing parameter id missing mandatory parameter id
400 missing parameter text missing mandatory parameter text
400 missing parameter recipients the recipient is missing
400 unknown type type can be only binary
401 unknown username/password wrong username or password
500 unknown error unknown error, detailed description is in response
Revision
Version Date Description
6.0 16.7.2014 first version