POST request

POST request to get message status

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

Headers

Name
Type
Description

Content-type*

String

text/json; charset=utf-8

Request Body

Name
Type
Description

login*

String

Your login in the system

password*

String

Your password in the system

token*

String

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

id_sms*

Int

SMS message number received in the response JSON-document in the process of sending SMS message

detail*

Int

0 or 1 in case it is necessary to receive the number of parts and the price for one part by SMS

[
    {
        "id_sms": 82216,
        "time_change_state": "2021-04-26 15:15:03",
        "state": "deliver",
        "num_parts": 1,
        "price": 10.6000000
    }
]

Deciphering parameters in query responses

Parameter
Data type
Description

id_sms

Int

SMS message number received in the response JSON-document in the process of sending SMS message

time_change_state

String

Time of message status change

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.

num_parts

Int

Number of SMS parts

price

Int

Price per SMS part

error

String

The error text can take the following values:

  • Incorrect JSON document format

  • Your account is locked

  • Incorrect login or password

  • POST data is missing

Example of SMS status request

[
    {
        "login": "login",
        "password": "password",
        "token":"token",
        "id_sms": "SMS ID in the system to check the status",
        "detail" : 1
    }
]

Last updated