上海贝尔联通SP接入VASP网关手册.doc

联通SP接入VASP网关手册 目 录1VASP网关介绍31.1SP接口31.2整体框架41.3业务流程图51.3.1短信点播51.3.2短信订购51.3.3WAP点播61.3.4WAP订购71.3.5彩信下发（业务类使用流程）72SP接入VASP网关流程92.1SPOA系统92.2SP提交信息93SP接口资料113.1Unicom ParlayX 彩信接口WSDL文件113.2SP和平台的接口技术要求（ParlayX分册）113.3SP应用管理接口113.4SP彩信ParlayX消息实例114联系人145FAQ155.1SP应用接入接口155.1.1关于ParlayX开发SDK？155.1.2下行消息返回错误，如何处理？155.1.3下行彩信，状态报告如何接收？155.1.4关于彩信多附件格式155.1.5destinationAddress字段格式155.1.6彩信下发TPS限定155.1.7附件大小限制175.2SP应用管理接口175.2.1CP-SP收不到定制/退定消息175.2.2关于包月退定175.3SP接入VASP流程171 VASP网关介绍1.1 SP接口Unicom VASP 平台接口按照ParlayX协议实现彩信业务，非传统的MM7接口与SP应用的接口 分为两大类：- SP应用接入接口提供统一的Parlay X接口，供SP应用程序调用。内网URL：http:/10.199.41.247:9081/pxmms/services/SendMessageService公网URL：http:/220.194.48.158:9081/pxmms/services/SendMessageService- SP应用管理接口定购关系同步接口：用户从业务管理平台进行业务定购，此定购信息同步给各SP应用程序。1.2 整体框架各省彩信中心及省份VASP网关Unicom总部VASP平台业务接入平台业务管理平台业务支撑系统彩信中心彩信中心SP时科新时讯中联掌讯联通综合接入网省份VASP平台各省彩信中心及省份VASP网关Unicom总部VASP平台业务接入平台业务接入平台业务管理平台业务管理平台业务支撑系统彩信中心彩信中心彩信中心彩信中心SP时科新时讯中联掌讯SP时科新时讯中联掌讯SP时科新时讯中联掌讯联通综合接入网联通综合接入网省份VASP平台省份VASP平台1.3 业务流程图1.3.1 短信点播用户使用短信点播后由VASP向客户下发资费提醒提示信息，信息包括业务的提供商、业务名称、信息费等。点播类业务下行第一条内容计费，其他下发内容不计费。流程如下：1.3.2 短信订购短信订购是指用户通过发送特定内容短信至指定短信接入号订购某一业务，短信可以订购彩信、WAP等多种业务。与Portal订购不同的是，Portal在订购时将会识别业务，将业务代码和产品代码传递给VASP系统，但是短信订购时VASP将需要匹配用户发送内容，如果发现是实现设置好的订购短信将会下发二次确认短信和用户确认完成订购动作。订购短信的匹配支持精确匹配和模糊匹配两种方式。流程如下：1.3.3 WAP点播1.3.4 WAP订购Portal订购是指用户在WAP门户上选择自己喜欢的业务发起订购，通过AAA的订购消息将订购请求传递给VASP，VASP和BSS交互，BSS确认成功后通知VASP，VASP将结果返回给门户，事后再通知相应SP。流程如下：1.3.5 彩信下发（业务类使用流程）这几类业务目前，SP都是通过调用统一的ParlayX接口给用户提供服务的，ParlayX与南向网元（彩信中心）进行交互，发送消息给终端用户，待南向网元返回发送成功消息后，ParlayX网关将会把鉴权批价确认消息通过AAA接口消息发送到SMP系统，SMP生成使用记录传递给BSS系统进行批价。流程如下：2 SP接入VASP网关流程2.1 SPOA系统SP在联通总部的SPOA上提交业务申请，其中WAP入口URL、WAP订购确认URL、返回上级测试页面URL、定制退订消息接口URL和SP接收“下发成功回执”服务器URL，请SP一定要确认好再填写，如果彩信业务不需要在WAP上做定制的，请不要填写。业务的定制/点播指令需要满足标准，不可出现相互覆盖的情况，如：定制命令字CXDNB，点播命令字CXD，这两个命令字在平台中存在相互覆盖关系，因此请SP在定自己的命令字时不要采用这种有覆盖关系的命令字。SPOA中的信息一旦变成测试中，这些信息将不能更改，如果更改该业务将被拒绝。SP下发彩信内容服务器公网IP地址请尽量固定。调用Parlay的密码规定是使用7位密码，编码规则：CX+SPID，如CX10000。业务申请成功后SPOA会给每个业务生成一个业务代码，该业务代码与SP的ServiceID是一样的，请各SP在看到业务代码后记录下来。SP在SPOA中提交的业务信息会被输入到VASP平台中，所以SP在申报时，一定要做好确认工作，减少不必要的时间成本。SP业务提交后，测试工作人员会与SP的业务负责人进行沟通，请各位在提交测试前确保：1、 SP的业务系统已经接入到MMSC中；2、 SP的定制退订URL工作正常，和平台通信正常；3、 SP的业务已经准备好，随时可以进入测试状态；4、 SP的各接口确认没有问题，不需要重新开发和调整；5、 SP各联系人的手机、座机在SPOA中填写正确。之后测试工作人员会给SP业务负责人发一份SP确认信息表和SP信息收集表，要求SP按照表格所列的内容进行填写并反馈给测试人员，测试人员会与SP联系，告知测试开始时间。2.2 SP提交信息SP在接入Unicom VASP平台前，需要提供以下信息。相应信息在VASP平台进行注册后方能接入VASP系统。SP名称SPIDSERVICE_ID接入码业务名称点播/订购方式公司名称（XXXX）90XXX200801XXXX1066XXXX手机电视报 200801XXXX天天彩信报 002903XXXX讯报2008  002903XXXX2008精彩瞬间 801170XXXX浓情佳节 SP接收上行短信URLSP接收上行彩信URLSP下行彩信的源地址（IP鉴权）SP联系人信息http:/220.194.XX.XX/services/SmsNotificationServicehttp:/220.194.XX.XX/services/MmsNotificationService220.194.58.35姓名/ mail/ 电话/MSN3 SP接口资料3.1 Unicom ParlayX 彩信接口WSDL文件Unicom ParlayX彩信接口非标准 ParlayX MMS接口。请按照提供的WSDL文件进行相应的开发。3.2 SP和平台的接口技术要求（ParlayX分册）请参看文档第十章多媒体消息。3.3 SP应用管理接口请参看CP_SP接口规范文档3.4 SP彩信ParlayX消息实例POST /pxmms/services/SendMessageService HTTP/1.1Content-Type: multipart/related; boundary=MIMEBoundaryurn_uuid_ABA4D2E3E2ED5926B71183449737682; type="text/xml" start="<0.urn:uuid:ABA4D2E3E2ED5926B71183449737683apache.org>" charset=UTF-8SOAPAction: ""User-Agent: Axis2Host: 10.199.41.247:9081Transfer-Encoding: chunked9bf-MIMEBoundaryurn_uuid_ABA4D2E3E2ED5926B71183449737682Content-Type: text/xml; charset=UTF-8Content-Transfer-Encoding: 8bitContent-ID: <0.urn:uuid:ABA4D2E3E2ED5926B71183449737683apache.org><?xml version='1.0' encoding='UTF-8'?><soapenv:Envelope xmlns:soapenv="http:/schemas.xmlsoap.org/soap/envelope/"><soapenv:Header><SPId xmlns=" xmlns=" xmlns=" xmlns=" xmlns=" xmlns="<soapenv:Body><ns3:sendMessage xmlns:ns3="<ns3:destinationAddress >tel:13001087103</ns3:destinationAddress ><ns3:senderAddress>889901</ns3:senderAddress><ns3:subject>Nice to meet you!</ns3:subject><ns3:priority>Normal</ns3:priority><ns3:charging><description></description><code>tel:13001087103</code></ns3:charging><ns3:receiptRequest><endpoint>http:/10.199.39.50/axis2/services/MessageNotificationService</endpoint><interfaceName>notification</interfaceName><correlator></correlator></ns3:receiptRequest></ns3:sendMessage></soapenv:Body></soapenv:Envelope>-MIMEBoundaryurn_uuid_ABA4D2E3E2ED5926B71183449737682Content-Type: application/smilContent-Transfer-Encoding: binaryContent-ID: <0.smil>-MIMEBoundaryurn_uuid_ABA4D2E3E2ED5926B71183449737682Content-Type: text/plain; charset=utf-8Content-Transfer-Encoding: binaryContent-ID: <109748.txt>-MIMEBoundaryurn_uuid_ABA4D2E3E2ED5926B71183449737682Content-Type: audio/midiContent-Transfer-Encoding: binarydd4Content-ID: <20007890.mid>-MIMEBoundaryurn_uuid_ABA4D2E3E2ED5926B71183449737682-0HTTP/1.1 200 OKServer: Apache-Coyote/1.1Content-Type: text/xml;charset=UTF-8Transfer-Encoding: chunkedDate: Tue, 03 Jul 2007 08:00:40 GMT16d<?xml version='1.0' encoding='UTF-8'?><soapenv:Envelope xmlns:soapenv="http:/schemas.xmlsoap.org/soap/envelope/"><soapenv:Header /><soapenv:Body><ns3:sendMessageResponse xmlns:ns3="<ns3:result>MMS2988a8d3f4de2c2f</ns3:result></ns3:sendMessageResponse></soapenv:Body></soapenv:Envelope>04 联系人有关SPOA系统，以及接入平台流程方面的问题请咨询：朱潇 zhuxiao5有关SP应用管理接口方面的问题请咨询：王宇熙 v-yuwang有关SP应用接入接口方面的问题请咨询：杨喜乐yangxile、 刘建 jliu042alcatel-5 FAQ5.1 SP应用接入接口5.1.1 关于ParlayX开发SDK？目前暂未提供SDK供SP开发使用。Web service开发易学易用，推荐使用第三方工具Apache Axis2  for Java / C 作为SOAP引擎，提高开发效率和产品兼容性。5.1.2 下行消息返回错误，如何处理？当首次调用SendMessage接口发送下行消息返回错误时，对于消息格式，最好先和我们提供彩信ParlayX消息实例，进行比对。如果未能发现问题，或对某一字段的含义不理解。请用Ethereal或Snoop工具抓一个完整的消息包（包括请求与平台回复的消息），发送给我们，不要将捕获的消息包贴到邮件文本里，最好以附件发送，在邮件里注明问题。这样有助于我们快速为你查找出错原因。5.1.3 下行彩信，状态报告如何接收？SP接收状态报告的地址应写在下行消息（SendMessage）receiptRequest字段内。当VASP平台收到用户返回的状态报告时，会根据此字段提供的地址信息，将状态报告递送给SP。<loc:receiptRequest> <endpoint>http:/10.199.41.152:8088/mockMessageNotificationBinding</endpoint> <interfaceName>notification</interfaceName> <correlator>PXGWIdx:80</correlator></loc:receiptRequest>5.1.4 关于彩信多附件格式目前平台支持MIME格式的附件下发，支持Multipart/Related 及 Multipart/Mixed格式的附件5.1.5 destinationAddress字段格式<destinationAddress>tel:13381158535</destinationAddress>对于+86，86 格式开头的号码均支持，例 +8613381158535， 86133811585355.1.6 彩信下发TPS限定由于目前Unicom各省彩信中心，建设规模不统一。所以对于全国业务，SP在对各省份进行彩信集中下发时，速率需要有一定的限制。SP在发送彩信时，需要根据各省的实际处理能力进行流量控制。超出流量限制， VASP会对SP发往该省份的消息进行拒绝，在SendMessageResponse中提示System overload。SP应当对SendMessageResponse返回消息进行监控，当收到Overload消息时，应适当降低发往该省的彩信速率，并考虑对失败的消息进行重发。SP在某一时段集中下发彩信时，需要根据号码段分省发送，并控制速率；为了提高效率，多个省份可以采用多进程/多线程方式并发发送，总速率不得超过100TPS。附各省处理能力，表格如下：省分建设规模分配给全网彩信手机报业务(TPS)(TPS)(10K)北京50238.3安徽20103.6甘肃1051.8宁夏1051.8青海1051.8重庆20103.6上海30155.4广东30155.4湖南20103.6江苏30155.4广西1051.8山西1051.8贵州1051.8陕西20103.6山东30155.4浙江30124.3天津1051.8云南1051.8福建20103.6海南1051.8湖北20103.6辽宁20103.6黑龙江20103.6内蒙古2082.9河南20103.6江西1051.8新疆1051.85.1.7 附件大小限制可以携带多个附件，每个附件需要有一个ContentID，整个彩信大小不要超过100K字节。5.2 SP应用管理接口5.2.1 CP-SP收不到定制/退定消息请检查网络和应用服务器情况。综合管理平台如果不能收到CP-SP应用服务器的正确响应，将不断重试，以保障CP-SP可以收到所有定制/退定消息。5.2.2 关于包月退定用户退定某一包月业务后，CP-SP应用服务器会收到综合管理平台的退定通知，请注意：订购关系终止的时间戳标记为自然月的月末。从用户退定到该月月末这段时期，综合管理平台保持此订购关系，CP-SP业务内容下发不会鉴权失败。5.3 SP接入VASP流程测试中的业务问题：对于测试中的业务，SP手中的手机号码不能进行定制，只有系统中测试号码才可以。如果SP希望参与自己业务的测试，请与联通总部负责人联系，并提供相应的手机号码，放入到测试号码中即可，一旦测试结束，该号码将退出。