MISC系统短信SP接入培训(精简版)_new

MISC系统短信SP接入培训,卓望科技,2005/03,SP接入MISC流程,接口改造分册,正反向订购接口开发说明,网站改造SSO接口流程说明,CMPP3.0接口开发说明,MISC系统结构和作用,MISC系统结构和作用,MISC(Mobile Information Service Center,移动信息服务中心,),是一个完全符合中国移动数据业务管理平台技术规范（,DSMP）,的数据运营平台,，,它完成数据业务的业务管理和控制功能，实现用户管理、业务管理和SP管理，对外提供开放的、标准统一的Web Service接口，并可以为各个业务网关、SP提供代计费。,二级管理平面,一级数据平面,梦网WAP门户/访问代理,梦网PDA门户/访问代理,梦网短信网关,梦网www门户,WAP网关,WAP SP,PDA SP,www SP,移动互联网/,Internet,SMS SP,中央,MISC,江苏省,MISC,广东省,MISC,浙江省,MISC,河南省,MISC,福建省,MISC,全网业务管理,SPOA,省级业务管理,SPOA,DSMP接口,中央BOSS,省级WAP门户/PDA门户/www门户/短信网关/省BOSS,省级业务管理,SPOA,省级业务管理,SPOA,SP接入MISC流程,组织SP培训,SP程序开发及业务梳理,安排SP在试验环境做接口测试,现网全业务申报,SP进行全业务自行拨测及相关程序调整,SP提交全业务拨测报告供计费验证,安排割接,N,N,SP接入MISC流程流程说明,1）首先需要组织SP参与MISC升级改造培训,2）培训结束后SP就应该开始着手进行业务梳理及接口程序开发，并在移动要求的时间内完成这项工作,3）SP具备接口测试条件以后，集中统一安排在测试环境做接口测试及典型业务申报,4）接口测试通过以后根据现网MISC系统建设情况，安排接口测试通过的SP在现网做全业务申报和全业务拨测,5）全业务拨测通过后提交拨测报告供计费做计费验证,6）验证通过后根据网络部的割接计划安排割接,接口改造总体说明,在整个升级改造过程中“接口改造”占了一个非常重要的位置。SP需要根据CMPP3.0协议和DSMP规范对自己的接口进行改造开发，才能接入MISC。,接口改造主要分为以下几个方面：,1）CMPP3.0接口程序改造,2）正反向订购、取消接口开发,3）网站改造SSO接口开发,CMPP3.0接口改造说明,接口开发需具备条件,CMPP2.0和CMPP3.0区别,CMPP3.0协议包体说明,接口改造需具备条件,1、自己开发接口的SP，应根据CMPP3.0协议对接口进行修改；使用API的SP，应向接入网关的省公司或网关厂家索取最新的CMPP3.0接口API以及使用说明等相关文档,2、不管是自己开发接口的，还是使用接口API的SP，都应该详细了解CMPP2.0和CMPP3.0的区别,CMPP2.0和CMPP3.0区别协议包的变化,1）CMPP_SUBMIT包内容的变化：,CMPP3.0中新增字段：,Fee_terminal_type：被计费用户的号码类型，0：真实号码；1：伪码,Dest_terminal_type：接收短信的用户号码类型，0：真实号码；1：伪码,LinkID：20个字节，点播业务使用，非点播类业务的MT流程不使用该字段,CMPP3.0中删除字段：,Reserve：保留字段。,CMPP3.0中变化字段：,Fee_terminal_id：被计费用户号码。长度扩展为32个字节，数据类型从,Unsigned Integer修改为Octet String,Dest_terminal_id：接收短信的用户号码。长度扩展为32个字节，数据类,型从Unsigned Integer修改为Octet String,CMPP2.0和CMPP3.0区别协议包的变化,2）CMPP_DELIVER包内容的变化,CMPP3.0中新增字段：,Src_terminal_type：源终端号码类型，0：真实号码；1：伪码,LinkID：20个字节，点播业务使用，非点播类业务的MT流程不使用字段,CMPP3.0中删除字段：,Reserve：保留字段,CMPP3.0中变化字段：,Src_terminal_id：源终端号码。长度扩展为32个字节，数据类型从,Unsigned Integer修改为Octet String,字段说明：,伪码：一个随机字符串，对于一个SP，唯一标识一个用户,LinkID：20位字符串，该字段的值由MISC产生，编码格式为4位MISCID+12,位时间+4位序列号。用于点播类业务中MT与MO消息的匹配。,CMPP3.0协议包体说明CMPP_SUBMIT,字段名,字节数,属性,描述,Msg_Id,8,Unsigned Integer,信息标识,Pk_total,1,Unsigned Integer,相同Msg_Id的信息总条数，从1开始。,Pk_number,1,Unsigned Integer,相同Msg_Id的信息序号，从1开始。,Registered_Delivery,1,Unsigned Integer,是否要求返回状态确认报告：,0：不需要；,1：需要。,Msg_level,1,Unsigned Integer,信息级别。,Service_Id,10,Octet String,业务标识，是数字、字母和符号的组合。,Fee_UserType,1,Unsigned Integer,计费用户类型字段：,0：对目的终端MSISDN计费；,1：对源终端MSISDN计费；,2：对SP计费；,3：表示本字段无效，对谁计费参见Fee_terminal_Id字段。,Fee_terminal_Id,32,Octet String,被计费用户的号码，当Fee_UserType为3时该值有效，当Fee_UserType为0、1、2时该值无意义。,Fee_terminal_type,1,Unsigned Integer,被计费用户的号码类型，0：真实号码；1：伪码。,TP_pId,1,Unsigned Integer,GSM协议类型。详细是解释请参考GSM03.40中的9.2.3.9。,TP_udhi,1,Unsigned Integer,GSM协议类型。详细是解释请参考GSM03.40中的9.2.3.23,仅使用1位，右对齐。,CMPP3.0协议包体说明CMPP_SUBMIT,Msg_Fmt,1,Unsigned Integer,信息格式：,0：ASCII串；,3：短信写卡操作；,4：二进制信息；,8：UCS2编码；,15：含GB汉字。,Msg_src,6,Octet String,信息内容来源(SP_Id)。,FeeType,2,Octet String,资费类别：,01：对“计费用户号码”免费；,02：对“计费用户号码”按条计信息费；,03：对“计费用户号码”按包月收取信息费。,FeeCode,6,Octet String,资费代码（以分为单位）。,ValId_Time,17,Octet String,存活有效期，格式遵循SMPP3.3协议。,At_Time,17,Octet String,定时发送时间，格式遵循SMPP3.3协议。,Src_Id,21,Octet String,源号码。SP的服务代码或前缀为服务代码的长号码, 网关将该号,码完整的填到SMPP协议Submit_SM消息相应的source_addr字段，,该号码最终在用户手机上显示为短消息的主叫号码。,CMPP3.0协议包体说明CMPP_SUBMIT,DestUsr_tl,1,Unsigned Integer,接收信息的用户数量(小于100个用户)。,Dest_terminal_Id,32*DestUsr_tl,Octet String,接收短信的MSISDN号码。,Dest_terminal_type,1,Unsigned Integer,接收短信的用户的号码类型，0：真实号码；1：伪码。,Msg_Length,1,Unsigned Integer,信息长度(Msg_Fmt值为0时：160个字节；其它=140个字节)，,取值大于或等于0。,Msg_Content,Msg_length,Octet String,信息内容。,LinkID,20,Octet String,点播业务使用的LinkID，非点播类业务的MT流程不使用该字段。,CMPP3.0协议包体说明CMPP_SUBMIT_RESP,字段名,字节数,属性,描述,Msg_Id,8,Unsigned,I,nteger,信息标识，生成算法如下：,采用64位（8字节）的整数：,时间（格式为MMDDHHMMSS，即月日时分秒）：bit64bit39，其中,bit64bit61：月份的二进制表示；,bit60bit56：日的二进制表示；,bit55bit51：小时的二进制表示；,bit50bit45：分的二进制表示；,bit44bit39：秒的二进制表示；,短信网关代码：bit38bit17，把短信网关的代码转换为整数填写到该字段中；,序列号：bit16bit1，顺序增加，步长为1，循环使用。,各部分如不能填满，左补零，右对齐。,（SP根据请求和应答消息的Sequence_Id一致性就可得到CMPP_Submit消息的Msg_Id）,Result,4,Unsigned Integer,结果：,0：正确；,1：消息结构错；,2：命令字错；,3：消息序号重复；,4：消息长度错；,5：资费代码错；,6：超过最大信息长；,7：业务代码错；,8：流量控制错；,9：本网关不负责服务此计费号码；,10：Src_Id错误；,11：Msg_src错误；,12：Fee_terminal_Id错误；,13：Dest_terminal_Id错误；,CMPP3.0协议包体说明CMPP_DELIVER,字段名,字节数,属性,描述,Msg_Id,8,Unsigned Integer,信息标识。,生成算法如下：,采用64位（8字节）的整数：,时间（格式为MMDDHHMMSS，即月日时分秒）：bit64bit39，其中,bit64bit61：月份的二进制表示；,bit60bit56：日的二进制表示；,bit55bit51：小时的二进制表示；,bit50bit45：分的二进制表示；,bit44bit39：秒的二进制表示；,短信网关代码：bit38bit17，把短信网关的代码转换为整数填写到该字段中；,序列号：bit16bit1，顺序增加，步长为1，循环使用。,各部分如不能填满，左补零，右对齐。,Dest_Id,21,Octet String,目的号码。,SP的服务代码，一般4-6位，或者是前缀为服务代码的,长号码；该号码是手机用户短消息的被叫号码。,Service_Id,10,Octet String,业务标识，是数字、字母和符号的组合。,TP_pid,1,Unsigned Integer,GSM协议类型。详细解释请参考GSM03.40中的9.2.3.9。,TP_udhi,1,Unsigned Integer,GSM协议类型。详细解释请参考GSM03.40中的9.2.3.23，,仅使用1位，右对齐。,CMPP3.0协议包体说明CMPP_DELIVER,Msg_Fmt,1,Unsigned Integer,信息格式：,0：ASCII串；,3：短信写卡操作；,4：二进制信息；,8：UCS2编码；,15：含GB汉字。,Src_terminal_Id,32,Octet String,源终端MSISDN号码（状态报告时填为CMPP_SUBMIT,消息的目的终端号码）。,Src_terminal_type,1,Unsigned Integer,源终端号码类型，0：真实号码；1：伪码。,Registered_Delivery,1,Unsigned Integer,是否为状态报告：,0：非状态报告；,1：状态报告。,Msg_Length,1,Unsigned Integer,消息长度，取值大于或等于0。,Msg_Content,Msg_length,Octet String,消息内容。,LinkID,20,Octet String,点播业务使用的LinkID，非点播类业务的MT流程不使,用该字段。,CMPP3.0协议包体说明CMPP_DELIVER_RESP,字段名,字节数,属性,描述,Msg_Id,8,Unsigned Integer,信息标识（CMPP_DELIVER中的Msg_Id字段）。,Result,4,Unsigned Integer,结果：,0：正确；,1：消息结构错；,2：命令字错；,3：消息序号重复；,4：消息长度错；,5：资费代码错；,6：超过最大信息长；,7：业务代码错；,8: 流量控制错；,9 ：其他错误。,CMPP3.0协议包体说明_网关返回状态报告,字段名,字节数,属性,描述,Msg_Id,8,Unsigned Integer,信息标识。,SP提交短信（CMPP_SUBMIT）操作时，与SP相连,的ISMG产生的Msg_Id。,Stat,7,Octet String,发送短信的应答结果，含义详见表一。SP根据该字段,确定CMPP_SUBMIT消息的处理状态。,Submit_time,10,Octet String,YYMMDDHHMM（YY为年的后两位00-99，MM：,01-12，DD：01-31，HH：00-23，MM：00-59）。,Done_time,10,Octet String,YYMMDDHHMM。,Dest_terminal_Id,32,Octet String,目的终端MSISDN号码(SP发送CMPP_SUBMIT消息,的目标终端)。,SMSC_sequence,4,Unsigned Integer,取自SMSC发送状态报告的消息体中的消息标识。,CMPP3.0协议包体说明_返回状态报告值,Message State,Final Message States,Description,DELIVERED,DELIVRD,Message is delivered to destination,EXPIRED,EXPIRED,Message validity period has,expired,DELETED,DELETED,Message has been deleted.,UNDELIVERABLE,UNDELIV,Message is undeliverable,ACCEPTED,ACCEPTD,Message is in accepted state(i.e. has been manually read on behalf,of the subscriber by customer service),UNKNOWN,UNKNOWN,Message is in invalid state,REJECTED,REJECTD,Message is in a rejected state,MA:xxxx,MA:xxxx,SMSC不返回响应消息时的状态报告,MB:xxxx,MB:xxxx,SMSC返回错误响应消息时的状态报告,MC:xxxx,MC:xxxx,没有从SMSC处接收到状态报告时的状态报告,CA:xxxx,CA:xxxx,SCP不返回响应消息时的状态报告,CB:xxxx,CB:xxxx,SCP返回错误响应消息时的状态报告,DA:xxxx,DA:xxxx,DSMP不返回响应消息时的状态报告,DB:xxxx,DB:xxxx,DSMP返回错误响应消息时的状态报告,SA:xxxx,SA:xxxx,SP不返回响应消息时的状态报告,SB:xxxx,SB:xxxx,SP返回错误响应消息时的状态报告,IA:xxxx,IA:xxxx,下一级ISMG不返回响应消息时的状态报告,IB:xxxx,IB:xxxx,下一级ISMG返回错误响应消息时的状态报告,IC:xxxx,IC:xxxx,没有从下一级ISMG处接收到状态报告时的状态报告,MISC常见错误代码说明,错误代码,错误描述,备注,101,手机号码错误,MT包中的计费号码或者接收号码不是梦网用户,102,用户停机,103,用户欠费,107,业务不存在,MT包中的Service_Id与SP在MISC中申报的业务代码不一致,108,业务暂停,MT包中所填的业务在MISC中已被暂停,115,用户没有订购此业务,SP向未订购该业务的用户下发MT消息,116,用户暂停此业务,SP向已暂停该业务的用户下发MT消息,140,用户没有点播该业务,点播类业务对应的MT中，业务代码、LINKID和MO中的不匹配,正、反向接口开发说明,正向同步PROVISION接口规范,正向同步PROVISION接口消息定义,正向订购、取消包示例,反向接口规范,反向订购接口消息定义,反向取消接口消息定义,反向订购、取消包示例,正向同步PROVISION接口规范流程图,正向同步PROVISION接口规范流程说明,正向同步PROVISION接口消息定义,功能描述,此接口在MISC因为某种情况更新了用户订购关系（包括订购、取消、暂停、激活）的时候，通过此接口发起和SP的更新订购关系的交互。,消息名,消息类型,消息方向,SyncOrderRelationReq,Request,MISC,SP,SyncOrderRelationResp,Response,SP,MISC,正向同步PROVISION接口消息定义,接口内容描述,SyncOrderRelationReq消息字段描述,：,返回定义,重要性,类型,说明,MsgType,必须,string,消息类型,TransactionID,必须,string,该消息编号,Version,必须,string,该接口消息的版本号，本次所有的接口消息的版本都,为“,1.5.0”,Send_Address,必须,address_info_schema,发送方的地址,Dest_Address,必须,address_info_schema,接收方的地址,FeeUser_ID,必须,user_id_schema,计费用户标识,DestUser_ID,必须,user_id_schema,使用用户标识,LinkID,可选,string,临时订购关系的事务,ID,ActionID,必须,integer,服务状态管理动作代码，具体值如下：,1： 开通服务；,2： 停止服务；,3： 激活服务；,4： 暂停服务；,正向同步PROVISION接口消息定义,ActionReasonID,必须,integer,产生服务状态管理动作原因的代码，具体值如下：,1：用户发起行为,2：Admin&1860发起行为,3：Boss停机,4：Boss开机,5：Boss过户,6：Boss销户,7：Boss改号,8：扣费失败导致的服务取消,9：其他,SPID,可选,string,SP的企业代码,SPServiceID,必须,string,SP中该服务的服务代码,AccessMode,可选,Integer,服务的访问方式,1：WEB,2：WAP,3：SMS,FeatureStr,可选,binary,服务订购参数（base64加密），内容是长号码空格用户发送内容,address_info_schema(地址信息)描述,字段名称,字段类型,字段描述,DeviceType,integer,设备类型,0,：,MISC,100,：,ISMG,101,：,WAP SP PROXY,1XX,：,其他业务网关,200,：,WAP PORTAL,201,：,WWW PORTAL,202,：,VOICE PORTAL,203,：,PDA PORTAL,2XX,：其他门户,300,：,MMSC,301,：,KJAVA SERVER,302,：,LSP,3XX,：其它应用平台,400,：,SP,DeviceID,string,设备编号，设备编号采用各设备的入网编号，例如短信网关使用网关,ID,、对,SP,使用其企业代码，该设备编号由,MISC,分配，并且在同一设备类型中该编号唯一,user_id_schema(用户标识)描述,字段名称,字段类型,字段描述,UserIDType,integer,用户标识类型,1,：用手机号标识,2,：用伪码标识,3,：两者同时标识,MSISDN,string,用户手机号,PseudoCode,binary,用户伪码,正向同步接口应答包消息定义,SyncOrderRelationResp消息字段描述：,字段名,重要性,类型,说明,MsgType,必须,string,消息类型,TransactionID,必须,string,该消息编号,Version,必须,string,该接口消息的版本号，本次所有的接口消息的版本都,为“,1.5.0”,hRet,必须,integer,返回值,，主要错误如下：,0,：成功,4007,：,MISC,同步开通服务,但,SP,端已存在订购关系,且状态为开通,4008,：,MISC,同步开通服务,且,SP,端不存在订购关系,但开通服务失败,4010,：,MISC,同步停止服务,且,SP,端存在订购关系,但取消服务失败,4011,：,MISC,同步停止服务,但,SP,端不存在订购关系,4012,：,MISC,同步暂停服务,且,SP,端存在订购关系,但暂停服务失败,4013,：,MISC,同步暂停服务,但,SP,端不存在订购关系,4015,：,MISC,同步激活服务,但,SP,端已存在订购关系,且状态为开通,4016,：,MISC,同步激活服务,但,SP,端不存在订购关系,其它错误请参见MISC系统短信SP接入指南接口改造分册。,正向订购、取消包示例,正向订购请求包,正向订购请求包,400,0,1,13805002425,1,13805002425,SP,1,1,911005,-TDXY,3,YWJjZGVm,正向订购、取消包示例,正向取消请求包,正向取消请求包,400,0,1,13805002425,1,13805002425,SP,2,1,911005,-TDXY,3,YWJjZGVm,反向订购接口规范流程图,反向订购接口规范流程说明,1）SP代替用户，向MISC发起反向订购请求SubscribeServiceReq,并等待MISC处理,2）MISC对消息中的来源地址、企业代码进行鉴权，判断是否允许,该SP进行反向订购,3）接入鉴权成功后，再进行用户鉴权和订购关系鉴权，判断用户状,态是否正确以及是否是重复订购等,4）上面鉴权成功后，MISC向SP发送订购关系同步请求包,SyncOrderRelationReq,5）SP收到同步请求后，对订购请求做相应的订购关系处理，并返,回订购关系同步应答SyncOrderRelationResp,6）MISC收到应答后，判断应答值是否为0。如果应答值为0，则在,MISC中生成正式的订购关系，并给SP返回成功的反向订购处理响应包,SubscribeServiceResp；如果应答值不为0，则不生成订购关系，同时,给SP返回不成功的反向订购应答包SubscribeServiceResp,7）SP如果收到MISC的错误响应，则说明订购失败，SP必须对这个失,败消息做相应处理，比如把自己先生成的订购关系清除掉等等,8）如果收到MISC的正确响应，则SP可以不做任何处理,反向订购接口消息定义,功能描述,此接口用于用户通过SP订购数据业务的时候，SP先进行业务关系订购，再通过该接口向MISC进行用户服务订购同步的请求。,消息名,消息类型,消息方向,SubscribeServiceReq,Request,SP,MISC,SubscribeServiceResp,Response,MISC,SP,反向订购接口消息定义,SubscribeServiceReq消息字段描述：,字段名,重要性,类型,说明,MsgType,必须,string,消息类型,TransactionID,必须,string,该消息编号,（,长度不能超过16位,）,Version,必须,string,该接口消息的版本号，本次所有的接口消息,的版本都为“,1.5.0”,Send_Address,必须,address_info_schema,发送方的地址,Dest_Address,必须,address_info_schema,接收方的地址,FeeUser_ID,必须,user_id_schema,计费用户标识,DestUser_ID,必须,user_id_schema,使用用户标识,当计费用户和使用用户为同个用户的时候，,FeeUser_ID,和,DestUser_ID,的值为相同，否则,填为不同的用户,Service_ID,必须,service_id_schema,服务标识,FeatureStr,可选,binary,订购特征参数，订购业务需要携带的参数，,可以携带文本,/,多媒体的相关信息,反向订购应答接口消息定义,SubscribeServiceResp消息字段描述：,字段名,重要性,类型,说明,MsgType,必须,string,消息类型,TransactionID,必须,string,该消息编号,Version,必须,string,该接口消息的版本号，本次所有的接口消息,的版本都为“,1.5.0”,hRet,必须,integer,返回值,见第,9,章的定义，如果返回成功，则,下面几个参数必须存在，否则是可选的,LinkID,条件,string,临时订购关系的匹配码，用来鉴权一次点播,请求等事务性的业务。当,MISC,生成的订购,关系为临时订购关系的时候，返回本字段，,否则不填本字段。,反向取消接口规范流程图,反向取消接口规范流程说明,1）SP代替用户，向MISC发起反向取消请求UnSubscribeServiceReq,并等待MISC处理,2）MISC对消息中的来源地址、企业代码进行鉴权，判断是否允许,该SP进行反向取消,3）接入鉴权成功后，再进行用户鉴权和订购关系鉴权，判断用户状,态是否正确以及是否存在订购关系,4）上面鉴权成功后，MISC向SP发送订购关系同步请求包,SyncOrderRelationReq,5）SP收到同步请求后，对订购请求做相应的取消处理，并返,回订购关系同步应答SyncOrderRelationResp,6）MISC收到应答后，判断应答值是否为0。如果应答值为0，则在,MISC中取消订购关系，并给SP返回成功的反向取消处理应答包,UnSubscribeServiceResp；如果应答值不为0，则不取消订购关系，同,时给SP返回不成功的反向取消应答包UnSubscribeServiceResp,7）SP如果收到MISC的错误响应，则说明取消失败，SP必须对这个失,败消息做相应处理，比如把已取消的订购关系恢复等等。,8）如果收到MISC的正确响应，则SP可以不做任何处理,反向取消接口消息定义,功能描述,此接口用于用户通过SP取消已订购的数据业务的时候，SP先通过该接口向MISC进行用户取消服务订购的请求。MISC进行取消服务订购成功后，SP才取消用户对应的业务订购关系。,消息名,消息类型,消息方向,UnSubscribeServiceReq,Request,SP,MISC,UnSubscribeServiceResp,Response,MISC,SP,反向取消接口消息定义,接口内容描述,UnSubscribeServiceReq消息字段描述,：,字段名,重要性,类型,说明,MsgType,必须,string,消息类型,TransactionID,必须,string,该消息编号,（,不能超过16位,）,Version,必须,string,该接口消息的版本号，本次所有的接口消息,的版本都为“,1.5.0,”,Send_Address,必须,address_info_schema,发送方的地址,Dest_Address,必须,address_info_schema,接收方的地址,FeeUser_ID,必须,user_id_schema,计费用户标识,DestUser_ID,必须,user_id_schema,使用用户标识,当使用用户和计费用户为同一用户的时候，,FeeUser_ID,和,DestUser_ID,的值相同。,Service_ID,必须,service_id_schema,服务标识,反向取消应答接口消息定义,UnSubscribeServiceResp消息字段描述：,字段名,重要性,类型,说明,MsgType,必须,string,消息类型,TransactionID,必须,string,该消息编号,Version,必须,string,该接口消息的版本号，本次所有的接口消,息的版本都为“,1.5.0”,hRet,必须,integer,返回值,。具体定义请参见,MISC,系,统短信,SP,接入指南接口改造分册,反向订购、取消包示例,SP反向订购请求包,反向订购请求包,0,0023,1,13805002424,1,13805002424,1,913002,-TQAAU,反向订购应答包,反向取消请求包,反向取消请求包,1,13805002424,1,13805002424,1,913002,-TQAAU,反向取消应答包,网站改造SSO流程,用户在SSO统一登录框中登录的处理流程,用户在SP网站上进行登录的处理流程,用户在整个梦网平台上签退的处理流程,用户订购业务与点播下载业务的处理流程,用户在中央,SSO,的,iframe,页面上登录,SP,网站（指移动梦网服务栏目）需要在规定的位置和大小，以,iframe,方式内嵌中央,SSO,平台的统一登录页面，嵌入时需要在,URL,中附加,SP,代码和处理完成后要求,SSO,平台重定向用户到的目的,URL,，以实现统一所有,SP,网站的梦网登录区域的目的。,统一登录页面登录,登录前,点击登录,点击登录,输入页面附加码,输入手机号码和梦网密码,统一登录页面登录,登录成功,用户在SP网站上进行登录的处理流程,由于在MISC平台和SSO平台的实施过程中，会存在由SP网站直接向业务接入地的SSO发起本地用户鉴权请求的情况，所以需要SSO平台向SP提供用户登录鉴权的功能。,SSO登录接口定义,用户登录接口,接口名称,SPLogon,接口描述,中央,SSO,平台向,SP,系统开放的用户登录功能接口，实现用户登录功能。,接口协议,HTTPS,协议,接口方向,请求：SP,中央,SSO平台,响应：中央SSO平台,SP,用户登录接口响应的参数描述：,响应中的BackURL上以BackURL?参数名称1=参数值1& 参数名称2=参数值2 的形式返回以下输出参数：,SSO登录接口定义,字段名称,字段说明,ResultID,SSO平台处理的结果，0表示成功，其它表示失败。,失败时不返回RandomSessionKey字段,ResultString,ResultIDid为0时，内容为”OK”,失败时将在本字段表示具体失败原因。,SeqNo,SP用于标识唯一一次认证请求的号码。,RandomSessionKey,用户登录成功后的临时会话标识。,AreaID,用户的归属地ID,编码如下：,0001： 北京 0023： 湖南,0002： 上海 0024： 福建,0003： 天津 0025： 甘肃,0004： 重庆 0026： 四川,0005： 黑龙江 0027： 广西,0006： 吉林 0028： 贵州,0007： 辽宁 0029： 海南,0008： 内蒙古 0030： 西藏,0009： 河北 0031： 新疆,0010： 河南 0032： 香港,0011： 广东 0033： 澳门,0012： 湖北 0034： 台湾,0013： 山东,0014： 浙江,0015： 安徽,0016： 江苏,0017： 江西,0018： 云南,0019： 宁夏,0020： 青海,0021： 山西,0022： 陕西,查询用户信息接口,接口名称,QueryUserInfo,接口描述,SSO,平台向,SP,系统开放的查询已登录用户信息接口。,为提高性能，建议,SP,使用查询用户信息接口,时使用,Keep-Alive,。,接口协议,HTTP协议,接口方向,请求：SP,中央,SSO平台,响应：中央SSO平台,SP,字段名称,字段说明,ICPCode,SP的企业代码，长度为6位，格式是9XYnnn, XY表示SP接入地的短信网关编号，nnn表示序列号。,ICPPassword,SP的密码，该字段要求使用统一的DES算法加密，并用SP的密码作为加密算法的密钥。,SeqNo,SP用于标识唯一一次认证请求的号码,RandomSessionKey,用户的临时会话标识,查询用户信息接口请求的参数描述：,查询用户信息接口响应的参数描述：,查询用户信息接口,响应中的BackURL上以BackURL?参数名称1=参数值1& 参数名称2=参数值2 的形式返回以下输出参数：,字段名称,字段说明,ResultID,SSO平台处理的结果，为0表示成功，其它表示失败。失败时将在ResultString字段将表示错误信息。,失败时不返回PseudoCode和MSISDN字段。,ResultString,ResultIDid为0时，内容为”OK”。,失败时将在本字段表示具体失败原因。,SeqNo,SP用于标识唯一一次认证请求的号码。,PseudoCode,用户伪码,要求可以配置成：当响应包中有MSISDN字段时，填或不填该字段。即当不填MSISDN时，此字段为必填,项；当响应包中有MSISDN字段时，则根据配置决定响应包中是否需要该字段。,MSISDN,用户手机号码（要求能维护一个icp列表，对列表中有的icp才填该字段，否则，响应包中不包含该字段）,AreaID,用户的归属地ID。,定义与用户登录接口响应信息中定义的AreaID一样。,OtherInfoNumber,返回包中Other_Info的个数。,Other_Info是为了今后能够灵活扩展接口中传递的信息而定义的数据类型。,本字段表明在该XML包中存在的Otner_Info的数目。,Other_Info,表示其他信息数据。,OtherInfoNumber等于多少，在该XML包中就有多少个Other_Info。,在Other_Info的结构中，包含两个字段：,InfoCode,： 表示信息代码,InfoValue,： 表示具体的信息值,用户订购业务与点播下载业务的处理流程,SP接入MISC平台的实施说明,由于MISC平台的建设有一个由点到面，逐步铺开的过程，因此在实施订购接口时需要考虑对于没有接入MISC的服务如何与已接入MISC的服务区别对待的问题。,根据服务接入MISC的情况不同，会有以下几种情况：,1）服务在MISC单点接入的情况,2）服务不在MISC接入的情况,3）服务多点接入时，主接入点和分接入点都接入MISC的情况,4）服务多点接入时，主接入点接入MISC，而分接入点没有接入MISC的情况,需要特别说明的是，在实现订购功能时，SP需要根据服务接入地选择SSO平台，即订购请求链接需要指向,服务接入地,的SSO平台，对于多点接入业务，则指向,服务主接入地,的SSO平台；如果服务接入地没有建设SSO平台，则指向中央SSO平台。,SSO订购、点播接口定义,业务订购与下载接口,接口名称,业务订购与下载,接口描述,SSO平台向SP系统开放的用户业务订购和下载功能接口，本接口根据参数的不同，有两种不同的用途：,完成业务订购、取消订购、激活订购和暂停订购等操作,完成下载类业务的临时订购，并返回临时订购关系ID,接口协议,HTTP协议,接口方向,请求：SP,中央,SSO平台,响应：中央SSO平台,SP,业务订购与下载接口请求的参数描述：,SSO订购、点播接口定义,字段名称,字段说明,ICPCode,SP的企业代码，长度最长为6位，格式是9XYnnn, XY表示SP接入地的短信网关编号，nnn表示序列号。,ICPServID,SP提供的短信业务的业务代码，变长（小于等于10位）的字符串。,如果是批量订购，则该字段可能包括多个业务代码，多个业务代码之间用逗号（“,”）分隔。,SeqNo,SP用于标识唯一一次认证请求的号码。,ItemID,用于标识SP的即时下发类业务（铃声、图片等）唯一性的标识，长度及格式由SP自行约定，应只包含数字,和ASCII字符。,本字段只对下载业务有效，即只有当ActionID为10时才需要，ActionID为其他值时参数中不应包含本字段,。,例如，如果用户订购的是天气预报、新闻等包月服务，则不需要带此参数。,MSISDN,用户在SP网站上输入的手机号码（此参数为可选参数）,ActionID,标识用户的操作，如订购、取消订购、暂停、激活等，长度为2位的整数，取值区间：,1：订购服务；2：取消服务；,3：激活服务；4：暂停服务；,10：点播下载服务。,BackURL,处理完成后要求SSO平台重定向用户到的目的URL。,DeliverURL,SP的服务下发请求接口地址。,该参数为可选参数，当订购完成后SP需要向用户下发服务时填写该参数（ActionID10时）。,当订购完成后还需要向用户下发服务时，SSO平台将向该参数定义的地址发起一个HTTP GET请求，以通,知SP向用户下发指定的服务，请求中携带的参数格式参见服务下发请求接口。,SSO订购、点播接口定义,业务订购与下载接口响应的参数描述：,响应中的BackURL以BackURL?参数名称1=参数值1& 参数名称2=参数值2 的形式返回以下输出参数：,字段名称,字段说明,ActionID,标识用户的操作，如订购、取消订购、暂停、激活等，长度为2位的整数，取值区间：参见上表。,ResultID,SSO平台处理的结果，0表示成功，其它表示失败。,失败时不返回ResultString字段。,如果是批量订购，则该字段中包含多个返回码，多个返回码之间用逗号（“,”）分隔，分别对应批,量订购中的每个服务。,例如，如果批量订购3个业务，第1和第2个服务订购成功，第3个服务由于服务代码错误订购失败,，则该字段的值为0,0,4110 。,ResultString,ResultID为0时，内容为”OK”,失败时将在本字段表示具体失败原因。,如果是批量订购且部分成功时，则该字段为“部分成功”,SeqNo,SP用于标识唯一一次认证请求的号码。,RandomSessionKey,用户登录成功后的临时会话标识。,ICPServID,SP提供的业务代码，变长（小于10位）的字符串。,TempAuthNo,由SSO平台生成的本次订购操作的临时订购关系ID，只对下载业务有效，即只有当ActionID为10或,5时才返回该字段，ActionID为其他值时不返回该字段。另外，只有在请求处理成功，即result为0,时才返回该字段。,SSO订购、点播接口定义,ItemID,用于标识SP的即时下发类业务（铃声、图片等）唯一性的标识，长度及格式由SP自行约定，建议只包含数字和ASC字符。其值将与请求中的ItemID的值相同。,本字段只对下载业务有效，即只有当ActionID为10时才返回本字段，ActionID为其他值时不返回本字段。,FeePseudoCode,计费用户伪码；,当响应包中没有FeeMSISDN时，此字段为必填项；当响应包中有FeeMSISDN字段时，则该字段为可选字段。,FeeMSISDN,计费用户的手机号码；,要求能维护一个icp列表，对列表中有的icp才填该字段，否则，响应包中不包含该字段,DestPseudoCode,被赠送者的用户伪码；当用户输入了多个被赠送用户手机号码时，多个伪码之间用逗号（“,”）分隔。,该字段仅当请求中的ActionID为5时有效，ActionID为其他值时不返回本字段；,当响应包中没有DestMSISDN时，此字段为必填项；当响应包中有DestMSISDN字段时，则该字段为可选字段。,DestMSISDN,被赠送用户的手机号码；当用户输入了多个被赠送用户手机号码时，多个号码之间用逗号（“,”）分隔。,该字段仅当请求中的ActionID为10时有效，ActionID为其他值时不返回本字段；,要求能维护一个icp列表，对列表中有的icp才填该字段，否则，响应包中不包含该字段,服务下发请求接口,接口名称,服务下发请求接口,接口描述,SP系统向SSO平台开放的服务下发请求接口用于完成向用户下发服务的功能。,该接口主要用于处理SSO平台在用户完成服务订购后需要向用户下发服务时的情况。,接口协议,HTTP 协议，使用GET请求,接口方向,请求： SSO平台,SP,响应：SP,SSO,平台,ICPCode,SP的企业代码，长度最长为6位，格式是9XYnnn, XY表示SP接入地的短信网关编号，nnn表示序列号。,ICPServID,SP提供的短信业务的业务代码，变长（小于等于10位）的字符串。,SeqNo,SP用于标识唯一一次认证请求的号码，该号码与SP在服务订购请求中的传入的SeqNo相同；,ItemID,用于标识SP的即时下发类业务（铃声、图片等）唯一性的标识。,该字段为可选参数；该字段的值与SP在服务订购请求中的传入的ItemID相同。,FeePseudoCode,计费用户伪码；,当响应包中没有FeeMSISDN时，此字段为必填项；当响应包中有FeeMSISDN字段时，则该字段为可,选字段。,FeeMSISDN,计费用户的手机号码；,要求能维护一个icp列表，对列表中有的icp才填该字段，否则，响应包中不包含该字段,DestPseudoCode,接收服务的用户的伪码；当需要向多个用户下发服务时，多个伪码之间用逗号（“,”）分隔。,当请求中没有DestMSISDN时，此字段为必填项；当请求中有DestMSISDN字段时，则该字段为可选字,段。,DestMSISDN,接收服务的用户的手机号码；当需要向多个用户下发服务时，多个号码之间用逗号（“,”）分隔。,要求能维护一个icp列表，对列表中有的icp才填该字段，否则，响应包中不包含该字段,LinkID,临时订购关系的匹配码，用来鉴权一次点播请求等事务性的业务。,服务下发请求接口的参数描述：,SP接入MISC流程,业务改造分册,点播、订购指令MO匹配,订购、取消及包月收取,SP升级前后特性对比,业务梳理及业务代码改造,MISC系统结构和作用,业务组合模式说明,特殊业务流程举例,业务改造重要性说明,业务改造是否合理决定了SP的业务能否顺利接入MISC，所以请各SP在培训完后尽快派专人进行分析和梳理业务的工作。业务改造分为以下几个步骤：,1）业务类型划分,2）业务代码整理,3）点播、定制指令设置,4）资费信息设置,5）反向订购业务申请,SP升级前后特性对比,项目说明,升级前状态,升级后状态,订购关系保存,所有订购关系由SP自行掌握,订购关系同时保存在MISC系统和SP系统中，但是以MISC系统,中,的订购关系为准,订购,、取消,通知下发,SP自行组包生成订购、取消通知消息下发给用户,MISC平台根据SP申报的短信提醒下发给用户,0000、00000统一取消指令,SP收到0000时组包产生取消菜单下发给用户，收到00000自行取消用户订购,关系,MISC平台拦截0000指令并自行组包产生菜单下发，拦截00000指令自动取消用户订购的,所有,业务,包月话单发起扣费,由SP自行发起SMC包月扣费请求,由MISC根据有效用户订购关系代SP发起SMC包月扣费请求,订购、点播,鉴权,不进行订购、点播鉴权，所有消息全部由网关透传给SP,所有的MO/MT消息都需要通过MISC的,鉴权,，实现有效拦截,订购关系同步,订购关系都保存在SP方，不存在订购关系同步,订购关系保存在MISC系统，所有的订购请求都由MISC通过Provision接口与SP同步,网站订购、点播处理,SP的网站点播和定制都由SP自身来控制，网关负责消息转发,SP的所有网站点播和定制业务都需要通过调用SSO接口来实现,业务梳理及改造过程,项目说明,升级前状态,升级后状态,业务类型梳理,CMPP2.0时期，业务类型分为三种：IOD、PUSH、STK类,升级后，业务类型按照最新的数据部管理规范，分为5种类型：点播,类,、定制,类,、STK点播,类,、STK定制,类,、,帮助信息类,业务代码整理,IOD类型业务代码统一设置为：XXXX，PUSH类型业务代码统一设置为：YYYY，STK类型业务代码设置为：+ZZZZ,点播类业务统一设置为：XXXX，定制类业务统一设置为：YYYY，STK点播的业务设为：ZZZZ，帮助信息类代码设为：HHHH,MO正向指令设置,所有的用户使用指令，包括手机点播和手机定制的指令都是由SP自行设置，网关不做任何处理,所有的手机点播和,手机,定制指令都必须在MISC平台,中有数据,，每次MO过程MISC都需要,根据指令内容和长号码来判断业务,特殊业务流程整理,SP根据自身业务推广需要，可以灵活设置不,同,的业务流程，网关不做限制,由于目前MISC不支持二次批价，所以很多SP的特殊业务，,例,如促销、打折等业务都需要首先按照MISC的管理规范来设置,业务类型分类说明,业务分类方法,从计费方式上分为：按条计费，包月计费，免费使用,从使用方式上分为：点播类，定制类,从点播，定制来源上分为：手机，网站，STK卡,业务分类原则,定制类业务允许按条、包月和免费三种资费类型，用户必须订购业务SP才可以下发信息,点播类业务不允许包月计费，用户必须点播后SP才可以下发信息,具体业务分类,定制类，STK卡定制类,点播类，STK卡点播类,帮助信息类,业务类型分类说明,定制类手机,用户必须订购，订购方式是使用手机MO上行信息，允许包月、按条、免费使用三种计费方式,业务申请时需要提交订购指令和退订指令,业务代码前以“-”号开头,定制类网站,用户必须订购，订购方式是通过SP网站或者是移动公司门户网站定制，允许包月、按条、免费使用三种计费方式,因为是在网站上进行交互方式订购，所以业务申请时不需要提交订购指令和退订指令,业务代码前以“-”号开头,STK定制类,用户必须订购，订购方式是通过固化在STK卡中的相关菜单，允许包月、按条、免费使用三种计费方式,业务申请时需要提交订购指令和退订指令，此指令已固化在STK卡中,业务代码前以“+”号开头,业务类型分类说明,点播类手机,用户必须点播SP才可下