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 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 get request:
http://client_url?batchSeq=I123645_2402010011_4450868&requestTime=240201001113&sellingPrice=0.5&receiver=&pswd=¬ifyTime=240201001115&price=0.5&mobile=8613900000000&msgid=447605524811111111&reportTime=2024-02-01T00:11:15.130Z&status=DELIVRD&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 GET parameters
| Parameter Name | type | required | describe |
|---|---|---|---|
| receiver | string | yes | The username for receiving verification is blank if not filled in during configuration. If configuration is required, please contact technical support |
| pswd | string | yes | The password for receiving verification will be left blank if not filled in during configuration. If configuration is required, please contact technical support |
| msgid | string | yes | The msgid of the interface response when submitting a text message |
| batchSeq | string | yes | SMS batch number |
| reportTime | string | yes | The status report time returned by the gateway platform is in the format YYMMDDhhmm, where YY=the last two digits of the year (00-99), MM=the month (01-12), DD=the day (01-31), hh=the hour (00-23), mm=the minute (00-59). There is a time difference in the time returned by the gateway platform |
| notifyTime | string | yes | The time when we pushed the status report. Format: yyMMddHHmmss |
| requestTime | string | yes | The submission time for SMS is within 24 hours in mainland China. Format: yyMMddHHmmss |
| mobile | string | yes | The phone number for receiving text messages and the number in the push report will default to a 00 at the beginning of the number. Example: 008613912345678. If you need the number format to be consistent with the one submitted, please contact our technical personnel to configure it |
| status | string | yes | SMS reception status, "DELIVRD" represents successful reception, all others are failures, please refer to the status report status code for specific meanings |
| smsNum | string | yes | Number of SMS billing entries |
| sellingPrice | string | yes | Unit price, the price of a single text message |
| price | string | yes | Cost (in RMB), the current SMS cost for this number=smsNum * sellingPrice |