获取彩信发送状态
调用GetMMSSendReceipt API获取彩信发送状态信息。
请求参数
参数名称 | 类型 | 描述 | 是否必需 |
---|---|---|---|
Action | string | 取值:GetMMSSendReceipt。 | 是 |
AccountId | int | 项目ID,获取AccountId。 | 是 |
SessionNoSet | []string | 发送彩信时返回的SessionNo集合。单次调用最多支持100个项。 | 是 |
- 在提交和发送彩信后,您可以调用GetMMSSendReceipt API查询和获取已发送彩信的状态信息。
- 如果在发送后没有立即收到状态回执,请建议在发送后5到10分钟后再次尝试调用。
- 如果超过12小时没有收到发送状态,您可以联系support@uspeedo.com寻求技术支持。
响应元素
参数名称 | 类型 | 描述 | 是否必需 |
---|---|---|---|
RetCode | int | 当RetCode不为0时,Message中显示具体的错误描述。如果RetCode为0,则不返回Message。 | 是 |
Action | string | 操作名称。 | 是 |
Message | string | 当RetCode不为0时,Message中显示具体的错误描述。 | 是 |
Data | []ReceiptPerSession | 状态信息的集合。详细字段描述请参见ReceiptPerSession。 | 是 |
ReceiptPerSession
参数名称 | 类型 | 描述 | 是否必需 |
---|---|---|---|
SessionNo | string | 发送彩信时返回的SessionNo。 | 是 |
ReceiptSet | []ReceiptPerPhone | 电话号码的状态信息集合。详细字段描述请参见ReceiptPerPhone。 | 是 |
ReceiptPerPhone
参数名称 | 类型 | 描述 | 是否必需 |
---|---|---|---|
Phone | string | 电话号码。 | 是 |
ReceiptResult | string | 发送状态结果。枚举值:Success-成功;Fail-失败;Unknow-未知;SubmitFail-提交失败。 | 是 |
ReceiptCode | string | 发送状态代码。 | 是 |
ReceiptDesc | string | 发送状态描述。 | 是 |
ReceiptTime | string | 发送状态报告的时间。 | 是 |
请求示例
curl --request POST 'https://api.uspeedo.com/api' \
--header 'Content-Type: application/json' \
-d '{
"Action": "GetMMSSendReceipt",
"AccountId": 1,
"SessionNoSet": ["session no"]
}'
返回示例
{
"Action": "GetMMSSendReceiptResponse",
"Data": [
{
"ReceiptSet": [
{
"Phone": "(1)1111111",
"ReceiptCode": "receipt code",
"ReceiptDesc": "receipt desc",
"ReceiptResult": "Success",
"ReceiptTime": 1672502400
}
],
"SessionNo": "session no"
}
],
"Message": "",
"RetCode": 0
}