狀態回調
更新時間 2024-11-08 16:39:46
最近更新時間: 2024-11-08 16:39:46
分享文章
本文將為您介紹狀態回調。
您可以指定HTTP URL來接收由SMS推送的短信發送狀態報告。然后SmsReport使用HTTP服務接收消息傳遞報告。
協議說明
| 參數 | 說明 |
|---|---|
| 協議 | HTTP+JSON |
| 編碼 | UTF-8 |
請求說明
請求內容為JSON Array 字符串格式,單次請求可能會包含多個狀態報告結果。
請求樣例
{
"data": [
{
"phone": "13900000001",
"sendTime": "2022-08-01 00:00:00",
"reportTime": "2022-08-01 00:00:00",
"reportCode": "DELIVRD",
"requestId": "mOiogcaBxn6YgaEQ",
"sessionId":"123456",
}
]
}
字段說明
| 名稱 | 類型 | 描述 | 示例值 | 是否必須 |
|---|---|---|---|---|
| data | Array | 狀態報告 | 必須 | |
| data.phone | String | 手機號碼 | 18900000001 | 必須 |
| data.sendTime | String | 發送時間 | 2022-05-01 00:00:00 | 必須 |
| data.reportTime | String | 狀態報告時間 | 2022-05-01 00:00:00 | 必須 |
| data.reportCode | String | 狀態碼 | DELIVRD | 必須 |
| data.requestId | String | 發送序列號 | mOiogcaBxn6YgaEQ | 必須 |
| data.sessionId | String | 發送短信時自定義 | 123456 | 非必須 |
| data.index | Int | 發送短信為長短信時,狀態報告分多條返回,標識長短信的序列號 | 1 | 非必須 |
響應說明
響應樣例
{
"code" : 0,
"msg" : "接收成功"
}
字段說明
| 名稱 | 類型 | 描述 | 示例值 | 是否必須 |
|---|---|---|---|---|
| code | Number | 應答編碼 | 0 | 必須 |
| msg | String | 描述信息 | 接收成功 | 可選 |
說明: httpStatus必須是200。