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

时间:2024-12-24 11:34:24

请求参数

表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常见取值,处理方法请参考状态报告错误码

statusDesc

String(1-500)

错误码描述,常见取值请参考表 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

SMS C未返回响应消息。

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

非报备签名拦截

support.huaweicloud.com/api-msgsms/sms_05_0003.html