四川联通NET号码接入规范V3.1.doc

四川联通NET网关取号 接口接入规范 版本号:V3.1 南京安讯科技有限责任公司  一概述 3 1.1总体目标 3 1.2参考文献 3 1.3术语定义 3 1.4使用对象 3 1.5适用范围 4 二总体规范 4 2.1接口架构 4 2.2接口规范总体描述 4 三接口规范 4 3.1参数列表 4 3.3HTTP跳转请求流程 6 3.4Ajax Get请求流程 7 3.5返回的错误代码 8 3.5测试示例（C# Code） 8  一概述 1.1总体目标 随着移动通信的迅速发展，丰富多彩的移动数据业务的出现，移动数据业务用户激增，移动数据业务将会成为运营商的巨大商机。由网络将手机号（MSISDN）自动传递给业务控制平台，不必用户输入用户名口令，具有身份认证方便性的天然优势。这是移动运营商能够主导整个价值链的一个关键技术手段。同时也极大的提高了用户使用业务的感受。 本接口描述了缩略语 移动互联网用户会话标识管理系统 HTTP HyperText Transfer Protocol 超文本传输协议 Radius Remote Authentication Dial In User Service 远程用户拨号认证系统 Service Provider 服务提供商 SGSN SERVICING GPRS SUPPORT NODE GPRS服务支持节点 GGSN Gateway GPRS Support Node 网关GPRS支持节点 VPN Virtual Private Network 虚拟专用网络 3.3HTTP跳转请求流程 HTTP跳转到初始跳转地址4:8080/netgw/GetMsisdn/redirect.aspx，并传入参数。请求访问 初始跳转地址?Axon_key=（参数1）backurl=(参数2)spname=(参数3)sppwd =(参数4) guid =(参数5)。 请求的参数如下，注意大小写及参数顺序： 参数名 说明 Axon_key 表示的是请求前生成的不重复的串，由请求方生成。Axon_key = md5(spname + sppwd + backurl + guid) 。 backurl 假设需要跳回的地址为url，则backurl=base64(url) spname 为请求名，spname=base64(spname) sppwd 请求密码，sppwd=base64(sppwd) guid 区别每个用户请求的不重复字符串. 如果各项参数输入正确， 则跳转至第一步请求的参数backurl中，并在url地址后面传回用户号码等信息。回传参数如下，注意大小写： 参数名 说明 axon_phone 该参数表示返回的用户标识信息（号码）。如果请求参数有错误，该回传参数将显示请求的错误信息。 axon_flag “false”或“true”， 表示是否请求成功。 Axon_key 表示的是请求前生成的不重复的串，由请求方生成。Axon_key = md5(spname + sppwd + backurl + guid) 。 backurl 假设需要回传的地址为url，则backurl=base64(url) spname 为请求名，spname=base64(spname) sppwd 请求密码，sppwd=base64(sppwd) guid 区别每个用户请求的不重复字符串. 3.4Ajax Get请求流程 1.在获取号码页面，通过Ajax Get方式提交到地址4:8080/netgw/GetMsisdn/response.aspx?Axon_key=（参数1）backurl=(参数2)spname=(参数3)sppwd =(参数4) guid =(参数5)。 参数如下，注意大小写及参数顺序： 参数名 说明 Axon_key 表示的是请求前生成的不重复的串，由请求方生成。Axon_key = md5(spname + sppwd + backurl + guid) 。 backurl 假设需要跳回的地址为url，则backurl=base64(url) spname 为请求名，spname=base64(spname) sppwd 请求密码，sppwd=base64(sppwd) guid 区别每个用户请求的不重复字符串. 获取提交后返回的结果。返回的结果各参数间以“”符号隔开。参数如下，注意大小写： 参数名 说明 axon_phone 该参数表示返回的用户标识信息（号码）。如果请求参数有错误，该回传参数将显示请求的错误信息。 axon_flag “false”或“true”， 表示是否请求成功。 Axon_key 表示的是请求前生