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 Name | type | required | describe |
---|---|---|---|
receiver | string | yes | The username for verification. If not filled in during configuration, it will be empty. Please contact the technical team if you need to configure it. |
pswd | string | yes | The password for verification. If not filled in during configuration, it will be empty. Please contact the technical team if you need to configure it. |
msgid | string | yes | The msgid in the interface response when submitting the SMS. |
batchSeq | string | yes | SMS batch number |
uid | string | yes | The uid passed to us by the client when submitting the SMS. If not passed, it will be our batchSeq. |
mobile | string | yes | The mobile phone number. |
accessNumber | string | yes | The access number. |
status | string | yes | The SMS receiving status. "DELIVRD" means successful reception, and others mean failure. See the status code in the status report for specific meanings. |
requestTime | string | yes | The time when the SMS was submitted, in timestamp format. |
reportTime | string | yes | The time of the status report returned by the gateway platform, in timestamp format. |
notifyTime | string | yes | The time when we push the status report, in timestamp format. |
fee | string | yes | The fee. The cost of the SMS sent by this number = smsNum * unitPrice. |
unitPrice | string | yes | The unit price, the price of a single SMS. |
currency | string | yes | The currency type. |
smsNum | string | yes | The number of charged messages. |
countryNumber | string | yes | The country code of the mobile phone number. |
regionCode | string | yes | The regional code of the mobile phone number. |
mnoName | string | yes | The name of the operator of the mobile phone number. |
mcc | string | yes | The mcc of the operator of the mobile phone number. |
mnc | string | yes | The mcc of the operator of the mobile phone number. |