北京联通SP管理系统培训文档(yzh).doc

中国联通北京分公司 联通在信业务 SP 管理系统 培训规范 SP V1 1 中国联通北京分公司 2004 年 02 月 27 日 目目 录录 1 版本与修改说明 2 2 总则 3 背景 3 文档内容 3 适用范围 3 术语与缩略语 3 参考文献 4 3 业务模型与优化 5 3 1 典型业务流程 5 4 SP 的接口 7 4 1 SP 与 SMG 之间的接口 7 4 2 SP 与 SPMS 之间的接口 8 5 SP 业务规范 18 1 1 版本与修改说明版本与修改说明 序号序号版本号版本号修改人修改人修改日期修改日期修改内容修改内容 11 0 2 2 总则总则 背景背景 目前联通在信网络基本运行正常 业务发展前景良好 但也存在一些问题 包括对 SP 缺乏有效的管理约束手段 业务内容和联通用户资料均由 SP 提供 无法监控 SP 下发消息的合法性 对用户利益造成损失 并影响联通的形象 同 时用户的订制及退订业务流程不统一 存在订制容易退订难的问题 不利于联 通在信业务的良性发展 鉴于以上原因 中国联通北京分公司计划建设联通在 信业务 SP 管理系统工程 并针对在北京 SMG 接入的本地 SP 进行管理 文档内容文档内容 本文主要规定了中国联通北京分公司联通在信业务 SP 管理系统 以下简称 SPMS 与其他应用系统的接口规范 适用范围适用范围 本文主要用于中国联通北京分公司联通在信业务 SP 管理系统建设中联通在 信业务提供商 SP 的配合 用于指导北分和 SP 业务建设的研发和实施 本文 适用于 SP CP SPMS 系统建设厂家和联通北京分公司的管理及技术人员等 术语与缩略语术语与缩略语 缩略语缩略语全称全称说明说明 SPSPService Provider 业务提供者 SMGSMGShort Message Gateway 短消息网关 SMSCSMSCShort Message Service Center 短消息中心 SMPPSMPPShort Message Peer to Peer 短消息点对点协议 SGIPSGIPShort message Gateway Interface Protocol 短消息网关接口协议 MOMOMobile Original 移动用户发送短消息 MTMTMobile Terminal 移动用户接收短消息 参考文献参考文献 短消息业务联网协议 1 2 版 短消息业务联网规范 1 2 版 中国联通北京分公司联通在信业务 SP 管理系统工程技 术 规 范 书 点对点短消息协议 SMPP3 4 3 3 业务模型与优化业务模型与优化 3 1 3 1 典型业务流程典型业务流程 3 1 1 3 1 1 手机手机 MOMO 点播流程点播流程 通信流程如下 1 手机用户发起短消息点播请求 2 本地 SMG 将该请求送往 SPMS 系统 由 SPMS 进行相应处理 如果判 断该用户是在正常点播某项业务 则记录相关 MO 请求记录并生成 唯一标识 linkid 以便 SP 下发 MT 消息时实现鉴权 3 SMG 将点播请求上行给 SP 在 DELIVER 包中携带此唯一标识 linkid 4 SP 处理点播请求 在相应的 SUBMIT 包中携带此唯一标识 linkid 5 SMG 将 SUBMIT 包送给 SPMS 作下行鉴权 SPMS 判断此 SUBMIT 包是 否是合法 并由 SMG 将该 SUBMIT 下发给用户 3 1 2 3 1 2 手机手机 MOMO 定制流程定制流程 1 手机用户发起业务订制请求 MO MO 内容为定制业务相关命令代码 2 SMG 将定制请求转给 SPMS SPMS 生成临时订制关系 向用户下发订制 确认短信 3 用户回复确认 Y 表订制 N 表取消 短信 4 SPMS 转发 Deliver 包给 SP 带 LinkID 5 SP 下发订制成功 失败通知包给用户 带 LinkID 6 SPMS 根据通知包生成正式订制关系 7 SP 根据订制规则向用户下发业务消息 不带 LinkID 8 SPMS 根据用户订制关系进行鉴权 3 1 3 3 1 3 手机取消定制流程手机取消定制流程 1 用户发起业务退订请求 MO MO 内容为退定定制业务的相关命令代码 2 SPMS 向用户下发退订确认短信 3 用户回复确认短信 4 SPMS 取消用户和该业务的订购关系 退订用户业务 转发 Deliver 包给 SP 带 LinkID 5 SP 下发退订成功 失败通知包用户 6 SPMS 根据 LinkID 及退订关系进行鉴权 3 1 4 3 1 4 网上注册流程网上注册流程 网上注册流程与网上点播流程相同 作为一项特殊的点播业务 3 1 5 3 1 5 网上点播流程网上点播流程 1 用户在网上点播业务 2 SP 通过 HTTP 方式调用 SPMS 点播接口 挂起用户请求 等待用户输入 确认码 3 SPMS 生成确认码并向用户下发确认码短信 4 用户收到确认码短信 在 WEB 页面上输入确认码 5 SP 下发点播消息 将用户输入的确认码作为 LinkID 填在 Sumit 包中 6 SPMS 根据确认码及点播关系进行鉴权 3 1 6 3 1 6 网上定制流程网上定制流程 1 SP 通过 HTTP 方式调用 SPMS 提供的定购接口 2 SPMS 生成临时订制关系 向用户下发订制确认短信 3 用户回复确认 Y 表订制 N 表取消 短信 4 SPMS 发 Deliver 包给 SP 带 LinkID 5 SP 下发订制成功 失败通知包用户 6 SPMS 根据通知包生成正式订制关系 7 SP 根据订制规则向用户下发业务消息 不带 LinkID 8 SPMS 根据用户订制关系进行鉴权 3 1 7 3 1 7 网上取消定制流程网上取消定制流程 1 用户在 SP WEB 上发起业务退订请求 2 SP 通过 HTTP 方式调用 SPMS 提供的业务退订接口 3 SPMS 向用户下发退订确认短信 4 用户回复确认短信 5 SPMS 退订用户业务 转发 Deliver 包给 SP 带 LinkID 6 SP 下发退订成功 失败通知包用户 带 LinkID 7 SPMS 根据 LinkID 及退订关系进行鉴权 4 4 SPSP 的接口的接口 4 1 4 1 SPSP 与与 SMGSMG 之间的接口之间的接口 SP 需规范 SGIP 协议的填写 具体需要注意的字段如下 4 1 1 4 1 1 DeliverDeliver 包中的包中的 ReserveReserve 字段字段 该 Reserve 字段为 8 个字节的保留字段 现将该字段作为 MO 和 MT 之间一 一对应的 LinkID 来用 该 Reserve 的值 LinkID 由 SPMS 业务鉴权平台生成 传给 SPSMG 由 SPSMG 不做任何改动传给 SP 用来标识点播的 MO 消息 使得 MT 如果 MO 引起多条 MT 则每条 MT 都要 将 MO 中的 Reserve 中的值取出 赋值到 Submit 包中的 Reserve 消息能够匹 配对应的 MO 消息 非 MO 所引起的 MT SP 不填写该 LinkID 4 1 2 4 1 2 SubmitSubmit 中的中的 ReserveReserve 字段字段 该 Reserve 字段为 8 个字节的保留字段 现将该字段作为 MO 和 MT 之间一 一对应的 LinkID 来用 该 Reserve 字段的值 LinkID 由 SPMS 业务鉴权平台生成 传给 SPSMG SPSMG 将对 MO 所引起的下发 MT 进行 Reserve LinkID 值的匹配校验 4 1 3 4 1 3 SubmitSubmit 包的包的 UserCountUserCount 字段填写限制字段填写限制 该字段 SP 下发时必须填写 1 否则视为业务非法包处理 4 1 4 4 1 4 SubmitSubmit 包的包的 MORelatetoMTFlagMORelatetoMTFlag 字段字段 在由该 MO 引起的 MT 中 第一条 MT 下行该字段为 0 以后的各条该字段为 1 定制信息请设置为 2 包月费下发信息设置为 3 4 2 4 2 SPSP 与与 SPMSSPMS 之间的接口之间的接口 4 2 1 4 2 1 SPSP 基本资料同步接口基本资料同步接口 发起方 SP 一个 SP 一条记录 接收方 SPMS 接口协议 FTP EMAIL 接口形式 文本文件 同步时间 已经接入到联通在信的 SP 可通过此文本文件将 SP 的基本信息 同步给 SP 管理系统 SP 也可不使用该接口 而直接登录 SP 管理系统的 SP 自服务门户 以手工录入的方法将 SP 基本信息提交给 SP 管理系统 文件命名 SP 5 位 SP 企业代码 8 位时间 4 位序号 TXT 如 SP30165200401010001 TXT 文件内容 文件以 TXT 格式存储 以下每个字段占据一行 序号序号字段名字段名最大长度最大长度 字节 字节 说明说明 1 SP 企业代码 5 不能为空 2 SP 的接入号码 10 3 SP 的地址 3 不能为空 4 SP 的守护端口不能为空 5 SP 的接入位置不能为空 6 SP 到 SPSMG 的用户 名 不能为空 7 SP 到 SPSMG 的口令不能为空 8 SPSMG 到 SP 的用户 名 不能为空 9 SPSMG 到 SP 的口令不能为空 10 SP 的开户银行不能为空 11 SP 的银行帐户不能为空 12正式商用日期 不能为空 13 主页地址 14 ICP 证号 15颁证单位 16 负责人姓名 17 负责人性别 18 负责人职务 19 负责人 Email 20 负责人办公电话 21 负责人移动电话 22 联系人姓名 23 联系人性别 24 联系人职务 25 联系人 Email 26 联系人办公电话 27 联系人移动电话 28 公司名称 29公司简称 30英文名称 31成立时间 32法人代表 33公司经理 34公司类型 35是否上市 36注册资金 37员工人数 38所在地 39主要业务 4 2 2 4 2 2 SPSP 业务资料同步接口业务资料同步接口 发起方 SP 接收方 SPMS 接口协议 FTP EMAIL 接口形式 文本文件 同步时间 已经接入到联通在信的 SP 需通过文件形式将 SP 已开通的业务 信息同步给 SP 管理系统 SP 管理系统根据已接入的业务资料对 MO MT 消息 进行鉴权 文件命名 SPST 5 位 SP 企业代码 8 位时间 4 位序号 TXT 如 SPST30165200401010001 TXT 文件内容 文件采用 ASCII 文本格式 文件体中一行作为一条记录 每一 条记录代表 sp 的一个业务 记录的属性值按顺序排列 各属性间使用 t 分隔 各条记录之间用换行符作为分隔 序序 号号 字段名字段名最大长度最大长度 字节 字节 说明说明 1SP 企业代码5 不能为空 2接入子号码7 不能填空 3 业务代码 12 不能填空 4 业务名称 8 不能填空 5 业务申请时间 16 不能填空 定义如下 6业务类别 点 播类 定制类 2 不能为空 0 定制 1 点播 7 业务收费模式 2 不能为空 0 按条 1 包月 8费率4 不能为空 9业务收费开始 时间 16 不能为空 10业务点播代码 点播类 10 不能为空 11业务定购命令 定制类 10 不能为空 12业务取消定购 命令 定制类 10 不能为空 13业务下发周期 定制类 2 不能为空 每日 14业务开展时间 段 定制类 6 不能为空 格式 nn nn 4 2 3 4 2 3 用户业务定购资料同步接口用户业务定购资料同步接口 发起方 SP 接收方 SPMS 接口协议 FTP EMAIL 接口形式 文本文件 同步时间 已经接入到联通在信的 SP 需通过文件形式将已定购 SP 业务的 用户信息同步给 SP 管理系统 文件命名 SPUS 5 位 SP 企业代码 8 位时间 4 位序号 TXT 如 SPUS30165200401010001 TXT 文件采用 ASCII 文本格式 文件体中一行作为一条记录 每一条记录代表 手机用户订购的一个业务 每条记录的属性值按顺序排列 各属性间使用 t 分隔 一个手机订购多项业务需要多条记录 各条记录之间用换行 符作为分隔 每个文件最大记录数为每个文件最大记录数为 1010 万条万条 超过的需要按照文件序列号递增的方 式生成新的文件 要求 UserNumber 必须和 ChargeNumber 一致 对于不 一致的用户业务订购关系 SPMS 系统将强制一致性 以 ChargeNumber 为准 序号序号字段名字段名最大长度最大长度 字节字节 说明说明 1 企业代码 5 不能填空 2 计费手机号码 21 不能填空 3 业务代码 16 4 目的手机号码 21 不能填空 5 定购方式 12 统一填 2 SP 同步 6 定制时间 20 不能填空 格式 YYYYMMDDHH24MISS 7 定购数量 12 不能填空 4 2 4 4 2 4 SPSP 业务定购业务定购 WEBWEB 调用接口调用接口 发起方 SP 接收方 SPMS 通讯协议 HTTP 认证机制 数字证书 IP 认证 SPMS 可限制连接的 IP 地址 用户身份验证 SP 必须先对用户以手机号注册 注册成功并登陆 SP 社区后 用户才能发起业务定购请求 即 SP 必须保证定购用户的真实性 接口说明 用户在 SP 网站上登录 选择订购的产品 在 SP 网站完成预订 购过程 预订购时 SP 调用此接口 接口方式为标准的 HTTP 参数传递采用 GET 方式 传递的参数包含校验码 SP 代码 SP 接入号 付费手机号码 目的手机号 业务代码 定购时间 定购数量 返回地址 其中 SP 代码 SP 接入号 返回地址采用明文传递 其他参数采用 SP 的私钥加密 SP 私 钥由 SPMS 通过邮件或 SP 门户的方式分发 SP 管理系统返回给 SP 预订购请 求是否成功 HTTP 调用参数 序序 号号 参数参数最大长度最大长度 字节 字节 含义含义说明说明 1CorpId10 SP 代码不能为空 如 30165 2SpNumber21 SP 的接入号码不能为空 3EncodeStr255 以 3DES 加密算法加 密字串 校验码 SP 代码 付费手机号 目 的手机号码 业务代 码 定购时间 定购数 量 不能为空 加密前的样例 1234 3016513000000000XW 2004 02 01 10 00 00 12 4BackUrl255 SPMS 处理完后的返回 地址 SP 可以根据 SPMS 的返回值显示给 用户定购结果 校验码 SPMS 将校验码原值返回 用户 SP 确认 SPMS 返回的有效性 EncodeStrEncodeStr 生成算法如下 生成算法如下 EncodeStr URLEncoding Base64 Encrypt CorpId SpNumber ChargeNumber UserNumber SvcTypeCode Count URLEncoding 是指对 BASE64 编码中的 HTML 控制码进行转义的过程 其具体实现 参见 RFC1738 Encrypt 加密算法采用 3 DES 算法 密钥为 64 位 密钥由 SPMS 通过 邮件或者 SP 门户网站提供的数字证书私钥 注 密钥是由 SPMS 为每个 SP 单独分发 的数字证书私钥 SP 加密后 SPMS 用对应的公钥解密 SP 对数据具有不可抵赖性 调用示例 umber 3333 AccessCode 2004 EncodeStr KIQWNWEQREQWK921343KJASDFASD BackUrl HTTP 调用返回参数 A SPMS 根据 SP 提供的 BackUrl 返回 校验码 AccessCode 付费手机号 ChargeNumber 处理结果 Result SPMS 处理成功 返回 OK SPMS 处理失败 返回 Error 错误码 返回示例 ChargeNumber 13000000 Result OK 4 2 5 4 2 5 SPSP 业务退定业务退定 WEBWEB 调用接口调用接口 发起方 SP 接收方 SPMS 通讯协议 HTTP 认证机制 数字证书 IP 认证 SPMS 可限制连接的 IP 地址 用户身份验证 SP 必须先对用户以手机号注册 注册成功并登陆 SP 社区后 用户才能发起业务退定请求 即 SP 必须保证定购用户的真实性 同时 SPMS 提供对用户的校验 接口说明 用户在 SP 网站上登录 选择退定的产品 在 SP 网站完成预退 定过程 预退定时 SP 调用此接口 接口方式为标准的 HTTP 参数传递采用 GET 方式 传递的参数包含 SP 代码 SP 接入号 付费手机号码 目的手机 号码 业务代码 退定时间 其中 SP 代码采用明文传递 其他参数采用 SP 的私钥加密 SP 私钥由 SPMS 通过邮件或 SP 门户的方式分发 SP 管理系统 返回给 SP 预订购请求是否成功 HTTP 调用参数 序序 号号 参数参数最大长度最大长度 字节 字节 含义含义说明说明 1CorpId10 SP 代码不能为空 如 30165 2SpNumber21 SP 的接入号码不能为空 3EncodeStr255 以 3DES 加密算法加 密字串 校验码 SP 代码 付费手机号 目 的手机号码 业务代 码 退定时间 不能为空 加密前的样例 1234 3016513000000000XW 2004 02 01 10 00 00 4BackUrl255 SPMS 处理完后的返回 地址 SP 可以根据 SPMS 的返回值显示给 用户定购结果 校验码 SPMS 将校验码原值返回 用户 SP 确认 SPMS 返回的有效性 EncodeStrEncodeStr 生成算法如下 生成算法如下 EncodeStr URLEncoding Base64 Encrypt CorpId SpNumber ChargeNumber UserNumber SvcTypeCode Count URLEncoding 是指对 BASE64 编码中的 HTML 控制码进行转义的过程 其具体实现 参见 RFC1738 Encrypt 加密算法采用 3 DES 算法 密钥为 64 位 密钥由 SPMS 通过 邮件或者 SP 门户网站提供的数字证书私钥 注 密钥是由 SPMS 为每个 SP 单独分发 的数字证书私钥 SP 加密后 SPMS 用对应的公钥解密 SP 对数据具有不可抵赖性 调用示例 umber 3333 AccessCode 2004 EncodeStr KIQWNWEQREQWK921343KJASDFASD BackUrl HTTP 调用返回参数 A SPMS 根据 SP 提供的 BackUrl 返回 校验码 AccessCode 付费手机号 ChargeNumber 处理结果 Result SPMS 处理成功 返回 OK SPMS 处理失败 返回 Error 错误码 返回示例 ChargeNumber 13000000 Result OK 4 2 6 4 2 6 SPSP 业务点播用户确认接口业务点播用户确认接口 发起方 SP 接收方 SPMS 通讯协议 HTTP 认证机制 数字证书 IP 认证 SPMS 可限制连接的 IP 地址 用户身份验证 SP 必须先对用户以手机号注册 注册成功并登陆 SP 社区后 用户才能发起业务点播请求 即 SP 必须保证点播用户的真实性 接口说明 用户在 SP 站点上点播业务时 需要确认该点播是由用户主动发 起 所以要求用户点播时输入由 SPMS 提供的点播确认码 以图片的方式提 示给用户 点播确认码由 SPMS 以短信方式下发给在网上进行点播操作的 用户手机 由用户通过确认页面重新输入系统 SPMS 根据确认图片随机码 确认该次请求是否合法 HTTP 点播调用参数 序序 号号 参数参数最大长度最大长度 字节 字节 含义含义说明说明 1CorpId10 SP 代码不能为空 如 30165 2SpNumber21 SP 的接入号码不能为空 3EncodeStr255 以 3DES 按 ECB 模式 加密算法加密字符串 校验码 SP 接入号 码 付费手机号 目的 手机号 点播标识 操 作命令字 点播时间 然后用 BASE64 算法 和 URLEncoding 算法 进行编码 不能为空 用户手机为网上 操作点播的用户 对于无命 令字的业务填写 4BackUrl255 SPMS 处理完后的返回 地址 SP 可以根据 SPMS 的返回值显示给 用户定购结果 校验码 SPMS 将校验码原值返回 用户 SP 确认 SPMS 返回的有效性 EncodeStrEncodeStr 生成算法如下 生成算法如下 EncodeStr URLEncoding Base64 Encrypt SpNumber UserNumber ServiceTag AccessTime URLEncoding 是指对 BASE64 编码中的 HTML 控制码进行转义的过程 其具体实现 参见 RFC1738 Encrypt 加密算法采用 3 DES 算法 密钥为 64 位 调用示例 umber 3333 AccessCode 2004 EncodeStr KIQWNWEQREQWK921343KJASDFASD BackUrl HTTP 点播调用返回参数 A SPMS 根据 SP 提供的 BackUrl 返回 校验码 AccessCode 付费手机号 ChargeNumber 点播标识 MessgeID 由 LinkID 处理失败不返回 处理结果 Result SPMS 处理成功 返回 OK SPMS 处理失败 返回 Error 错误码 返回示例 ChargeNumber 13000000 MessageID 18016 LinKID 2031 Result OK 处理流程 A 用户在 SP 站点点播业务时 SP 网站用标准的标准的 HTTP 方式向 SPMS 系统的点播确认接口提交一个请求 B SPMS 将给网上点播操作的用户的手机发送点播确认码 C SP 网站将提供一个点播确认码输入框在点播确认的页面上 用户填写 点播确认码 用户提交点播请求后 SPMS 根据 SP 提供的返回地址 将 操作结果返回 SP 操作成功的返回中包含 LinkID 点播确认码 随机 码 和 SP 提供的点播标识 SP 根据返回下发消息 并将 LinkID 加到 下发的 SGIP 包中 填写在 Reserved 字段中 提交 MT 到 SPSMG D SPSMG 接收到此 MT 请求 交给 SP 管理系统中的业务鉴权中心 业务鉴 权中心读取数据库 发现此 LinkID 点播确认码 随机码 有效 允 许发送 5 5 SPSP 业务规范业务规范 命令字最大长度为 12 位字符 命令字只能由 0 9 A Z a z 此 64 个字符构成 不能使用其它特殊字符 SPMS 解析命令字时 遇到除此 64 个字符外的其它字符 即认为命令字已结束 如 TQDZ 010 TQDZ 020 TQDZ 020 会被解析为同一个业务请求 在 MO 业务请求消息中 建议命令 字与其它内容以空格或 号分隔 对于 SP 的定制类业务