应用工厂开放平台短信能力接口规范

《应用工厂开放平台短信能力接口规范》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、天翼空间应用工厂开放平台《短信接口规范》中国电信股份有限公司应用商店运营中心修订表日期版本修改说明作者2011-01-27V1.0初稿王平2011-04-19V1.0新增状态上报参数SMSNumber，标识本次短信拆分条数王平2011-12-16V1.0新增模式类型字段PIdType，用于能够对应用鉴权王平文档变更记录目录1.用户场景描述11.1短信发送时序图：12.SENDSMS发送短信给终端22.1SendSMSRequest请求输入参数22.2SendSMSResponse返回参数63.NOTIFYSMSDELIVERYSTATUS状态

2、上报接口83.1NotifySmsDeliveryStatusRequest参数83.2NotifySmsDeliveryStatusResponse参数94.示例：114.1.1Md5加密：114.1.23DES加密：115.附录141.1.用户场景描述长短信业务提供一次可以比普通短信业务发送更多短信内容的服务。SI请求长短信业务，组织相关业务参数发送到应用工厂，应用工厂收到SI请求后返回给SI一个处理请求成功或失败的信息，应用工厂将短信内容向接收号码发送，接收号码接收短信的状态将以HTTP协议的Post方式发送给SI，SI收到上报后给予应

3、用工厂一个响应。1.1短信发送时序图：图1.1短信发送时序图第15页1.SendSMS发送短信给终端应用发送请求到应用工厂，要求应用工厂发送短信给终端用户。接口名称短信发送请求---SendSMS.Request接口描述短信下行接口协议http请求访问地址http://125.64.11.43:8080/udt-see/StartServiceServlet接口方向应用请求->能力开放平台填写说明：接口名称——短信发送请求---SendSMS.Request；接口描述——短信下行；接口协议——HTTP协议；访问地址——电信固定地址；http:

4、//125.64.11.43:8080/udt-see/StartServiceServlet；接口方向——应用请求->能力开放平台；1.1SendSMSRequest请求输入参数输入参数（客户发起）：序号名称必填类型描述1serviceIdYString服务ID（值为：00001020101130）2paramsYRequestListJson格式请求参数集合RequestList结构：序号名称必填类型描述1APIDYString应用工厂为SI分配的ID值2KeyYString安全标识，由3DES加密算法加密TimeStamp和APID组合

5、的字符串得到,加密的密钥由应用工厂分配。3MsgYString短信内容，最大长度为：第15页内容按GBK编码，不包含双字节字符长度为600字符，包含双字节字符最大长度为300字符。短信小于70个字按1条计算，超过70个字按67字拆分。短信中包括英文和中文的，英文和数字也算1个字；短信中只有英文、数字的，英文和数字算0.5字。4TimeStampYString长度为14位的时间戳（格式：YYYYMMDDHHMISS）5IsReportYString是否需要上报短信发送状态0-需要上报1-不需要上报6StatusReportUrlNString短

6、信发送状态上报地址。当IsReport=0时，地址不能为空，否则将收不到状态信息。7ProductIDYStringPIdType＝1：此处填写产品能力ID；PIdType＝9：此处填写应用ID。注：产品ID和应用ID均由应用工厂分配。8NumYString短信接收号码，如：136603600009IsUseNString是否在短信回复中使用应用下发短信时附带的备用参数，并将备用参数随短信下发状态一起上报给应用。1--使用，0--不使用。10UserIDNString用户ID11PIdTypeNString模式类型：1：普通模式(默认值)9:

7、应用管理模式12Parm1NString备用参数。当该字段的值等于字符串“SMS+UP+SCDX”第15页时，下发短信使用的IMS号码将使用公共号码，这种情况下将不能使用短信回复功能，但是可以有大量的IMS号码为应用的短信发送功能服务；如果是其它值，且应用拥有为其分配的IMS号码，则将使用这些分配的IMS号码为应用的短息发送功能服务，这种情况下可以使用短信回复功能，但是短信下发量会受其所拥有的IMS号码数量的限制；如果是其他值，且应用不拥有为其分配的IMS号码，则仍然可以使用短信发送功能，但是不能使用短信回复功能。13Parm2NString

8、备用参数14Parm3NString备用参数填写说明：（1）serviceId定义电信能力的业务ID，每产生一个新的业务时，均会为该业务生成一个新的、唯一的ID，其