Webcom Mobi API Docs
RU
  • Introduction
  • СПОСОБЫ ВЗАИМОДЕЙСТВИЯ С A2P ПЛАТФОРМОЙ
    • JSON specification
      • Sending SMS, Viber, Flash SMS, WAP-Push
      • SMS status request
        • POST request
        • Webhook
      • Balance check request
    • HTTP GET specification
      • Sending SMS
      • Sending Viber
      • Sending Cascade
      • Request message status
      • Registration
    • XML specification
      • Sending SMS, Viber, Flash SMS, WAP-Push
      • SMS status request
        • POST request
        • Webhook
      • Balance check request
      • Request to receive a list of senders
      • Request to add senders
      • Request for incoming SMS
      • Request for information by phone number
      • Request for obtaining the list of bases
      • Request to change parameters, add/remove bases
      • Request for receiving the list of subscribers of the base
      • Request to add/edit/delete subscribers of the base
      • Request to get the list of numbers from the STOP list
      • Request to add/remove subscribers to the STOP list
      • Request to receive the list of scheduled SMS
      • Request to delete a scheduled SMS
      • Request to get the time of change of something
      • Request for time verification
      • File upload request
      • Request to refill users' balance
    • ВЗАИМОДЕЙСТВИЕ С ПЛАТФОРМОЙ MSG (НЕОФ КАНАЛЫ)
    • Specification JSON
      • Чекинг базы номеров
Powered by GitBook
On this page
  • POST request to get message status
  • Deciphering parameters in query responses
  • Example XML request
  1. СПОСОБЫ ВЗАИМОДЕЙСТВИЯ С A2P ПЛАТФОРМОЙ
  2. XML specification
  3. SMS status request

POST request

POST request to get message status

POST http://lk.mysmpp.ru/xml/state.php

Headers

Name
Type
Description

Content-type

Sting

text/xml; charset=utf-8;

Request Body

Name
Type
Description

login.value*

Sting

Your login in the system

token.value*

Sting

You can use a secret key instead of login and password. To obtain it, please contact your manager

password.value*

Sting

Your password in the system

get_state.id_sms*

Int

The SMS message number received in the response XML document during the SMS message sending process.

<?xml version="1.0" encoding="utf-8" ?>
<response>
     <state id_sms="SMS ID in the system to check the status" time="2011-01-01 12:57:46" sms="Status">Status</state>
     <state id_sms="SMS ID in the system to check the status" time="2011-01-01 12:57:46" sms="Status" viber="Status">Status</state>
     <state id_sms="SMS ID in the system to check the status" time="2011-01-01 12:57:46" viber="Status">Status</state>
</response>
<?xml version="1.0" encoding="utf-8"?>
<response>
     <error>Error message</error>
</response>

Deciphering parameters in query responses

Parameter
Data type
Description

state

String

Last message status:

  • "send" - message status not received. In this case, an empty time (time="") is transmitted

  • "not_deliver" - the message was not delivered. Final status (does not change with time)

  • "expired" - the subscriber was not in the network at the moments when the delivery attempt was made. Final status (does not change with time)

  • "deliver" - the message has been delivered.

  • "read" - the message has been read. Final status (does not change over time)

  • "partly_deliver" - the message was sent, but the status was not received.

state.id_sms

Int

XML document in the process of sending SMS message

state.time

String

Time of status change

state.sms, state.viber

String

Message status.

The name of the field depends on the type of the message to be sent and resent

error

String

The error text can take the following values:

  • Incorrect XML document format

  • Incorrect login or password

  • POST data is missing

Example XML request

<?xml version="1.0" encoding="utf-8" ?>
<request>
    <security>
        <login value="login" />
        <password value="password" />
    </security>
    <get_state>
        <id_sms>IDSMS in system to check status</id_sms>
        <id_sms>IDSMS in system to check status</id_sms>
        <id_sms>IDSMS in system to check status</id_sms>
        <id_sms>IDSMS in system to check status</id_sms>
    </get_state>
</request>

Last updated 1 year ago