消息&短信 MSGSMS-接收状态报告API:请求参数

时间：2024-01-16 09:01:29

消息&短信 MSGSMS

请求参数

表2 请求Headers参数
参数名称	是否必选	参数类型	默认值	说明
Content-Type	是	String	无	固定填application/x-www-form-urlencoded。

表3 请求Body参数说明
参数名称	是否必选	参数类型	默认值	说明
smsMsgId	是	String(1-50)	无	发送短信成功时返回的短信唯一标识。
total	否	String(1-2)	无	长短信拆分后的短信条数。当短信未拆分时该参数取值为1。
sequence	否	String(1-2)	无	长短信拆分后的短信序号，当total参数取值大于1时，该参数才有效。当短信未拆分时该参数取值为1。
status	是	String(1-7)	无	短信状态报告枚举值，常见取值请参考表 Status常见取值，处理方法请参考状态报告错误码。
source	否	String(枚举)	无	短信状态报告来源： 1：短信平台自行产生的状态报告。 2：短信中心返回的状态报告。 3：华为平台产生的状态报告。
updateTime	否	String(1-20)	无	短信资源的更新时间，通常为短信平台接收短信状态报告的时间，为UTC时间，格式为：yyyy-MM-dd'T'HH:mm:ss'Z'，该时间会通过urlencode转义为%3a。当短信平台未收到短信中心上报的状态报告时，会自行构造状态报告，该状态报告中不携带“updateTime”参数。
extend	否	String(1-128)	无	扩展字段，由用户在发送短信的请求中携带。若用户发送短信时未携带extend参数，则状态报告中也不会携带extend参数。
to	否	String(1-21)	无	本条状态报告对应的短信的接收方号码，仅当状态报告中携带了extend参数时才会同时携带该参数。

表4 Status常见取值
取值	含义
DELIVRD	用户已成功收到短信。
EXPIRED	短信已超时。
DELETED	短信已删除。
UNDELIV	短信递送失败。
ACCEPTD	短信已接收。
UNKNOWN	短信状态未知。
REJECTD	短信被拒绝。
E200018	国内短信发送方通道校验失败。
E200019	国内短信发送方匹配通道失败。
E200020	国内短信签名通道校验失败。
E200021	国内短信签名匹配通道失败。
E200022	国内短信接收方通道校验失败。
E200023	国内短信接收方匹配通道失败。
E200025	国际短信接收方通道校验失败。
E200026	国际短信接收方匹配通道失败。
E200027	匹配网关失败。
E200032	短信需要模板。
E200034	短信重传超时。
E200035	短信协议字段替换失败。
E200036	南向速率管控配置为0。
E200038	接收长短信超时。
MILIMIT	号码达到分钟下发限制。
LIMIT	号码达到下发限制。
BEYONDN	号码达到下发限制。
KEYWORD	短信关键字拦截。
BLACK	号码黑名单。
MBBLACK	号码黑名单。
DJ:0255	运营商拦截，一般是因为短信内容不允许发送。
1	此类错误码多为手机号码问题，如手机为空号，关机，停机等。
24
MK:xxxx
MN:xxxx
LT:0001
MA:xxxx	SMSC未返回响应消息。
MB:xxxx	SMSC返回错误响应消息。
MC:xxxx	未从SMSC处接收到状态报告。
CA:xxxx	SCP未返回响应消息。
CB:xxxx	SCP返回错误响应消息。
DA:xxxx	DSMP未返回响应消息。
DB:xxxx	DSMP返回错误响应消息。
SA:xxxx	SP未返回响应消息。
SB:xxxx	SP返回错误响应消息。
IA:xxxx	下一级ISMG未返回响应消息。
IB:xxxx	下一级ISMG返回错误响应消息。
IC:xxxx	没有从下一级ISMG处接收到状态报告。
SC:0001	人工审核拦截
SC:0002	人工审核告警拦截
SC:0003	黑名单拦截
SC:0004	红名单拦截
SC:0005	投诉黑名单
SC:0006	禁用关键字拦截
SC:0007	特征关键字拦截
SC:0008	管控关键字拦截
SC:0009	缺失必备关键字
SC:0010	短信超频拦截
SC:0011	时段管控拦截
SC:0012	人工审核超时处理
SC:0013	签名黑名单拦截
SC:0014	免审核模板匹配
SC:0015	拦截模板匹配
SC:0016	退订黑名单拦截
SC:0017	非报备模板拦截
SC:0018	非报备签名拦截