Status report push

This interface is enabled by default, and the loopback address server needs to start an HTTP service to receive status reports. After receiving the status report, users need to write their own method to handle the received parameters.

Push request

  • URL:http://client_url
  • Push method:POST
  • Request header :Content-Type: application/json

Push binding status report receiving address

📘

Log in to https://innopaas.com and configure the SMS settings data push menu for the corresponding SMS product

Example explanation

For example, the SMS return address set by the user account is: http://client_url So when the 253 platform receives the SMS status returned by the operator, it will access the following URL with a post request:

curl --location 'http://client_url' \
--header 'Content-Type: application/json' \
--data '{
    "batchSeq": "I8393346_2506101652_35",
    "unitPrice": "0.05670",
    "countryNumber": "0086",
    "mnc": "2",
    "receiver": "account",
    "pswd": "password",
    "mnoName": "中国移动",
    "notifyTime": "1749545540975",
    "fee": "0.0567",
    "mobile": "8618888888888",
    "msgid": "627239445736452096",
    "mcc": "460",
    "requestTime": "1749545538198",
    "uid": "I8393346_2506101652_35",
    "regionCode": "CN",
    "accessNumber": "508tongdao",
    "currency": "CNY",
    "status": "DELIVRD",
    "reportTime": "1749545540967",
    "smsNum": "1"
}'
🚧

Note: If the first push is unsuccessful, it will be pushed a second time. If the second push is unsuccessful, it will be pushed a third time. If the third push is unsuccessful, it will not be pushed again. The interval time is 1 minute.

Push POST parameters


Parameter Nametyperequireddescribe
receiverstringyesThe username for verification. If not filled in during configuration, it will be empty. Please contact the technical team if you need to configure it.
pswdstringyesThe password for verification. If not filled in during configuration, it will be empty. Please contact the technical team if you need to configure it.
msgidstringyesThe msgid in the interface response when submitting the SMS.
batchSeqstringyesSMS batch number
uidstringyesThe uid passed to us by the client when submitting the SMS. If not passed, it will be our batchSeq.
mobilestringyesThe mobile phone number.
accessNumberstringyesThe access number.
statusstringyesThe SMS receiving status. "DELIVRD" means successful reception, and others mean failure. See the status code in the status report for specific meanings.
requestTimestringyesThe time when the SMS was submitted, in timestamp format.
reportTimestringyesThe time of the status report returned by the gateway platform, in timestamp format.
notifyTimestringyesThe time when we push the status report, in timestamp format.
feestringyesThe fee. The cost of the SMS sent by this number = smsNum * unitPrice.
unitPricestringyesThe unit price, the price of a single SMS.
currencystringyesThe currency type.
smsNumstringyesThe number of charged messages.
countryNumberstringyesThe country code of the mobile phone number.
regionCodestringyesThe regional code of the mobile phone number.
mnoNamestringyesThe name of the operator of the mobile phone number.
mccstringyesThe mcc of the operator of the mobile phone number.
mncstringyesThe mcc of the operator of the mobile phone number.