开发者
让沟通无国界,让交流畅通,让心灵互通
SMS Receipt Callback
Brief description
  • SMS receipt (DR) push

Request URL
  • The Http interface address pushed by DR (provided by the user)

  • Example: http://106.15.34.94:8989/sms/testDr

Request method
  • POST x-www-form-urlencoded

  • For customers who registered before May 4, 2023/, the parameters are in the url. For subsequent customers, the parameters are in the post body.

Parameter
Parameter Required Type Description
phone Yes stringMobile number
status Yes string Status code: 2: Successfully issued. All other numbers have not been issued successfully
result Yes string Reply content: DELIVRD\ UNDELIV
drtime Yes string Reply report time, format: yyyy-MM-dd HH:mm:ss
messageid Yes string SMS id, the id obtained after a successful SMS submission
currency Yes string The currencies of "price" include: CNY/USD
price Yes string The unit price of text messages corresponding to the currency
rate Yes string The exchange rate of the US dollar against the Chinese yuan is as follows: 7.05
sendtime Yes string Send time, in the format: yyyy-MM-dd HH:mm:ss
size Yes string Number of billing entries
ext No string Transparent transmission field: This field is a non-mandatory field in the SMS downlink sending interface. Once filled in, it will be returned as it is in the reply slip. It only supports http
Push example

For previously registered customers, the url passes the parameters


POST http://106.15.34.94:8080/sms/testDr?result=DELIVRD&size=1&phone=6282167624806&rate=6.4845&price=0.045&messageid=b308d94a73f94e6d84ae975c41f4b2a6&drtime=2021-02-26 10:01:15&currency=USD&sendtime=2021-02-26 10:01:15&status=2


2023/5/24 Customers who register later


POST http://106.15.34.94:8080/sms/testDrContent-Type: x-www-form-urlencoded result=DELIVRD&size=1&phone=6282167624806&rate=6.4845&price=0.045&messageid=b308d94a73f94e6d84ae975c41f4b2a6&drtime=2021-02-26 10:01:15&currency=USD&sendtime=2021-02-26 10:01:15&status=2

The corresponding code for the receipt status

public static final int DELIVRD = 2; // Success

public static final int UNDELIV = 5; // Failure

public static final int REJECTD = 6; // Refuse

public static final int EXPIRED = 7; // Expired

public static final int DELETED = 8; // Delete

public static final int DND = 9; // Do not disturb

public static final int ESME_RINVDSTADR = 10; // Wrong number

public static final int ESME_RINVSRCADR = 11; // Wrong sender

public static final int UNKNOWN = 12; // Unknown

User return value

Return the string "success" upon success and "error" upon failure

Remarks

Note: DR Is only pushed once. If you need to push again, please contact customer service. The messageid of the batch SMS = the messageid of the response - a 10-bit random number (20190909151515701-1234567890)