移动和联通接口调用具体分析 .doc

移动和联通接口调用具体分析 一、ChinaMobile 中国移动接口方案 二、中国联通接口方案 一、ChinaMobile 中国移动接口方案 接口名称采用单词首字母大写，其他字母小写的方式。缩略语中的字母都大写；接口参数和消息内 容定义中，基本数据类型的字段命名规范采用单词首字母大写，单词间没有连接符的方式；对于缩写单 词，例如ID，URL、ICP、MSISDN 等，将统一采用大写。 由于内部平台互联也需要走公网，因此建议在用户登录等涉及用户敏感关键数据的接口中使用HTTPS 协议，其他不涉及关键敏感数据的接口使用HTTP 协议。 ChinaMobile移动短信平台(SSO)向SP 系统提供四个接口，如下表: 编号 接口名称 接口描述 1 用户登录 向SP 系统开放SSO 平台用户登录接口 2 用户签退 向SP 系统开放SSO 平台用户签退接口 3 查询用户信息 向SP 系统开放使用临时会话ID 查询登录用户信息 4 用户业务订购与点播 向SP 系统开放实现业务订购和点播的接口 接口定义如下 : 平台向SP 系统提供的接口中，用户登录接口使用HTTPS 协议，其他接口则使用HTTP 的协议。 请求数据传输格式如下 : [接口URL]?[参数名称1]=[参数值1] [参数名称2]=[参数值2 1 用户登录 接口名称 用户登录 接口描述 SSO平台向SP 系统开放的用户登录功能接口，本接口根据参数的不同， 有两种不同的用途： 1) 判断用户是否已在SSO 平台登录 2) SSO 平台用户登录 接口协议 HTTPS协议 接口URL /sso/login 接口输出参数 处理情况 : 1) 如果用户没有在 平台进行登录，则提示用户登录，并在登录成 功后重定向用户请求到请求参数中携带的SP 的BackURL 上 2) 如果用户已经在 平台上进行登录，则 平台生成一个临时会 话标识RandomSessionKey，并重定向用户请求到请求参数中携带的 SP 的BackURL 上 平台提供的URL 中输入参数对说明： 字段名称 字段说明 ICPCode SP 的企业代码 SeqNo SP用于标识唯一一次认证请求的号码 BackURL 处理完成后要求平台重定向用户到的目的URL 处理完成后，无论成功与否， 平台都将重定向用户到BackURL，并以： [BackURL]?[参数名称1]=[参数值1] [参数名称2]=[参数值2] 的形式返回以下输出参数： 字段名称 字段说明 ResultID 平台处理的结果，0 表示成功，其它表示失败。 失败时不返回RandomSessionKey 字段 ResultString ResultIDid 为0 时，内容为”OK” 失败时将在本字段表示具体失败原因。 SeqNo SP用于标识唯一一次认证请求的号码。 RandomSessionKey 用户登录成功后的临时会话标识，SP 根据此标识来查询用户信息。 AreaID 用户的归属地ID 2 查询用户信息 接口名称 查询用户信息 接口描述 平台向SP 系统开放的查询登录用户信息接口 接口协议 HTTP协议 接口输入参数 接口URL: /sso/queryuserinfo 接口参数： 1） ICPCode : SP 的企业代码，长度为6 位，格式是9XYnnn, XY 表 示SP 接入地的短信网关编号，nnn 表示序列号。 2） ICPPassword: SP 的密码，该字段要求使用统一的3DES 算法加 密，并用SP 的密码作为加密算法的密钥。 3） SeqNo: SP 用于标识唯一一次认证请求的号码 4） RandomSessionKey: 用户的临时会话标识 接口输出参数 输出报文格式按照XML 规范 ，具体内容如下： ?xml version = “1.0” ? ssouserinfo version=”1.5” ResultIDResultID/ResultID ResultStringResultString/ResultString 20 SeqNoSeqNo/SeqNo PseudoCodePseudoCode/PseudoCode MSISDNMSISDN/MSISDN AreaIDAreaID/AreaID OtherInfoNumbern/OtherInfoNumber Other_Info InfoCodeInfoCode_1/InfoCode InfoValueInfoValue_1/InfoValue /Other_In