联通SP管理平台与SP接口说明书.docVIP

SP管理平台与SP 接口说明书 华为技术有限公司 2004年8月 目 录 1. 概述 3 1.1. 接口概述 3 1.2. 名词解释 3 2. 短信接口 4 2.1. SP通过短消息反向定购的接口 4 3. SP业务订购关系初始化接口 7 3.1. 概述 7 3.2. 文件提供方式 7 3.3. 文件格式 7 3.3.1. 文件命名格式 7 3.3.2. 文件记录格式 8 3.4. 导入数据步骤 9 3.5. Sp用户订购关系数据举例 9  概述 接口概述 SP管理平台与SP之间的接口分以下几部分： 短信接口：主要包括SP业务定购关系反向同步功能。为减少SP的开发难度，加速业务的开展，接口利用SP与短信网关间现有的SGIP接口。SP通过短信网关以转发短信给短信管理平台完成用户定购关系的反向同步。（如果SP没有反向同步的需求，不用该接口。） 重定向接口：用户在SP的网站上进行定购/点播时，需要重定向到SP管理平台的网站。重定向时使用的HTTP操作的参数的定义也需要约定。（如果SP没有通过web定购业务的需求，不用该接口。） 文件接口：文件接口作为消息接口的补充。接口采用FTP协议，SP管理平台在用户定购/取消定购处理时生成定购关系变动文件，SP定时到SP管理平台下载对应的定购关系变动文件，SP管理平台需要记录SP的下载日志。该接口主要是为了防止网络错误时造成定购关系数据的不同步。（如果SP是新接入的，没有定购关系，不用该接口。） 名词解释 服务代码： 服务代码是在使用短信方式的点播类业务中，提供给用户点播的内容/应用服务提供商代码。服务代码以数字表示，。 业务代码：业务代码表示业务类别，由内容/应用服务提供商自己制定，由字母或数字组成（其中字母大小写均可），长度最大为10位。 用户操作代码：在业务点播或业务定购时的参数，为描述业务具体内容，由SP自行定义，如不需要，可以不用。 间隔符：为用户短信内容中用于分隔各字段的固定字符，一般为空格 短信接口 SP给管理平台的短信门户发送短信目前只能使用编码方式0、4、8、15，不能使用其他编码方式。推荐使用15，不然超长短信被网关分拆之后第二条等会出现乱码。 SP通过短消息反向定购的接口 SP发起的反向同步消息的消息接口如下：（管理平台的接入号码为8133, SP的接入号码为8136） 接口说明 UserNumber 短消息内容 Part1 Part2 Part1 Part2 Part3 Part4 Part5 Part6 反向 同步 1001 - Comm OperationType SequenceID UserID SvcID UserOperation 反向 同步 应答 9999 Comm SequenceID Status - - 说明： SP 发送反向同步消息到8133 SMPA 发送反向同步应答消息到8136 SP反向同步请求消息，该消息以SUBMIT承载，在短消息内容中，字段参数的取值如下： 字段名 类型 长度 说明 Comm OctetString 4 命令字 “0003”表示反向定购同步请求 OperationType OctetString 1 操作类型 1：表示定购同步； 2：表示取消定购同步 SequenceID OctetString 1~10（变长） 消息流水号： 无符号整数的字符串表示， 0~UINT_MAX(4294967295) UserID OctetString 1~21（变长） 用户手机号码。 SvcID OctetString 10 (变长) 业务代码 UserOperation OctetString 0~40（变长） 用户操作码（可有可无，不是必须的） 反向同步请求应答用 DELIVER 消息承载，短消息内容字段参数的取值如下： 字段名 类型 长度 说明 Comm OctetString 4 命令字 “8003”表示定购同步应答 SequenceID OctetString 1~10（变长） 消息流水号： 无符号整数的字符串表示， 0~UINT_MAX(4294967295) Status OctetString 1~10（变长） 状态码 请求消息和应答消息中的SequenceID必须相同。 Status的取值如下表所示。状态码使用无符号整数的字符串表示： 值 说明 0 操作成功 101 手机号码错误 102 用户状态非法 107 业务不存在 111 业务尚未开通 115 用户未定购该业务 6001 内部数据库错误 6002 用户已经定购该业务 6003 其他消息参数不合法 6015 非法的用户ID 6025 SP的