tencent cloud

短信

文档短信API 文档SMS Callback APIsSMS Sending Status Notification

SMS Sending Status Notification

Download
聚焦模式
字号
最后更新时间： 2024-12-19 10:53:14

API Description

Feature description

This API is used for Tencent Cloud SMS to notify the business of the message sending status by calling back the service URL after an SMS message is sent to a user.

Sample URL

POST http://example.com/sms/callback

Request Parameters

The following table lists the request parameters.
Parameter
Required
Type
Description
user_receive_time
Yes
string
The time when the user actually receives the message
nationcode
Yes
string
Country/Region code
mobile
Yes
string
Mobile number
report_status
Yes
string
Whether the SMS message is actually received. Valid values: SUCCESS (success), FAIL (failure)
errmsg
Yes
string
Error message of receipt status code. For more information, see Error Codes for SMS Sending and Receipt Status
description
Yes
string
Description of SMS receipt status.
sid
Yes
string
Sending ID (corresponding to the SerialNo returned by the sending API)
Note:
A callback request may return the results of multiple SMS requests.
Sample request:
[
    {
        "user_receive_time": "2015-10-17 08:03:04",
        "nationcode": "86",
        "mobile": "13xxxxxxxxx",
        "report_status": "SUCCESS",
        "errmsg": "DELIVRD",
        "description": "The SMS message is successfully delivered",
        "sid": "xxxxxxx"
    }
]

Response Parameters

The following table lists the response parameters.
Parameter
Required
Type
Description
result
Yes
number
Error code. 0: success; other values: failure
errmsg
Yes
string
When result is 0, it displays "OK", and when result is not 0, it displays a specific error message.
Sample response:
{
    "result": 0,
    "errmsg": "OK"
}
上一篇: Error Codes for SMS Sending and Receipt Status下一篇: SMS Reply

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈