vac与sp接口规范

vac 与 sp 接口规范篇一：中国联通 VAC 平台接口技术要求 VAC 与 SP 接口规范6 中国联通VAC 平台接口技术要求： VAC 与 SP 接口规范 （暂定名） （） 中国联通公司发布 目 次修改记录 .II 前 言 . III 1 范围 . 4 2 规范性引用文件 . 4 3 定义与缩略语 . 4 定义 .4 缩略语 .4 信息更新时机定义 .5 4 VAC 和 SP 间的接口 . 5 定购通知接口 .5 接口描述 .5 发起方系统 .5 接受方系统 .5 接口协议 .5 接口内容 .5 订购关系通知 SP 请求（OrderRelationUpdateNotifyReq） . 5 订购关系通知 SP 响应（OrderRelationUpdateNotifyRsp） . 6 定购关系同步接口 .7 接口描述 .7 发起方系统 .7 接受方系统 .7 接口协议 .7 接口内容 .7 请求文件头（定长） . 7 文件体 . 8 过渡阶段定制关系变更通知 SP 通用流程 9 修改记录前 言本标准是中国联通增值业务鉴权中心系列标准之一，本系列标准的预期结构如下： 中国联通增值业务鉴权中心（VAC）技术体制 本标准将根据业务的开展情况与市场需求，适时进行修改。 本标准由中国联通公司增值业务部提出。 本标准由中国联通公司技术部归口。 本标准主要起草单位：中讯邮电咨询设计院，中国联通增值业务部 本标准主要起草人： 本标准的修改和解释权属中国联通公司。 中国联通增值业务鉴权中心接口技术要求：VAC 平台与 SP 接口规范 （） 1 范围 本标准规定了中国联通 VAC 与 SP 之间的接口。适用于联通、省分公司和厂家进行 VAC 和 SP 系统互联建设的研制、开发和实施，是中国联通 VAC、SP 接入规划和建设的基本依据。 2 规范性引用文件 下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。 3 定义与缩略语 定义 本标准采用以下定义： 1) 业务：业务是一定的内容和/或服务能力的聚合。业务名称是用户用以识别不同的增值业务的 标识。在管理上，业务是服务提供商与运营商进行审核管理和分成结算的对象。如“新浪酷图”业务。 2) 业务能力：指基础增值服务，例如：邮件、消息、浏览、流媒体等，可以使用这些业务能力进 行组合，构造出特定的业务，满足细分市场后的用户需求。 3) 业务引擎：指实现各个业务能力的物理实体。 4) 产品：产品是对业务的标价，是用户购买业务的方式，即用户使用业务所需要支付的价钱、支 付的方式、以及其能够获得的使用额度。在 VAC 系统中，产品是订购、鉴权、和计费的对象，如“包月 5 元” 。一个业务对应多个产品，一个产品唯一对应一个业务。 5) 内容：内容是用户真正使用的对象，是在业务中提供的一个个实体，如“手机酷图”业务中的 一个图片。 6) 门户：指直接面对用户的界面。增值业务鉴权中心通过多种承载形式提供给用户多样化的操作 能力，如业务订购、取消、查询、导购、帮助等。基于不同的承载形式，门户可以包括 WAP 门户、WEB 门户、短信门户和语音门户。 缩略语 本标准采用以下缩略语： VAC Value-added Service Platform 增值业务鉴权中心 AAA Authentication Authorization Account 认证授权计费 Brew Binary Runtime Environment for Wireless 无线二进制运行环境 CDMA Code Division Multiple Access 码分多址 DM Device Management 设备管理 DRM Digital Right Management 数字版权管理 IM Instant Massage 即时消息 GSM Global System for Mobile communication 全球移动通信系统 篇二：VAC 与 SP 接口说明 1015VAC 与 SP 接口说明 各位合作伙伴： 由于 VAC1212 版本已在 7 月 8 日上线，此版本对 SP订购关系的通知接口进行了完善和功能增强，请新接入的SP 遵照 VAC1212 版本 SP 通知接口规范执行，做好程序开发调试工作。 需重点注意以下几点： 2、关于 FTP 方式订购关系通知的说明：VAC 将文件放到 VAC 为 SP 提供的文件服务器的目录下。双方通过文件传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。 VAC 文件服务器 IP 地址： 外网： 内网： VAC 为 SP 分配具有读写文件权限的用户和密码： SP 帐号：sp+spid（如：sp30014） ； SP 帐号密码：sp+spid（如：sp30014） ，SP 可 telnet修改密码。 如 SP 发现使用该帐户密码无法登陆，请联系吴工由吴工进行统一登记处理。 ? add/requst 目录为订购关系文件准实时接口目录（大约每小时生成一次文件） ，SP 每天要定期清理该目录保证数据入库核对，如没有每日定期清理核对（取完文件后必须进行删除） ，将对 SP 进行相关考核。 文件中 updatetype 为三个类型： Updatetype=4 可视为订购（在文件接口中要注意剔除重复订购关系） Updatetype=1 订购Updatetype=2 退订 ? FTP 全量稽核 全量文件路径：all/request，VAC 每月 15 日凌晨定时生成 sp 的全量订购关系，SP 每月需要定期清理（5 天内，即 20 日凌晨前）该目录保证数据入库核对，如没有每月定期清理（取完文件后进行删除）核对，将对 SP 进行相关考核。 FTP 接口为实时接口必要的补充和核对机制，SP 必须与自己的订购关系数据库进行核对。 如果文件中存在的订购关系，SP 订购关系数据库没有的，须加入数据库；文件中已经退订的订购关系，SP 订购关系数据库还存在的，须从 SP 数据库中剔除该订购关系。 通过上述方式保证订购关系与 VAC 完全一致。如下次SP 说因网络等问题没有实时收到订购关系，而文件夹中的订购关系却仍然在文件夹里，SP 要自负责任。 3、针对 linkid 的说明 广东 VAC1212 版，采用 8 位随机数来表示，在参看附件文件时注意。 4、针对 SGIP 接口的说明 在 VAC1212 版本上线后仍不能提供附件中的改号操作的实时通知，建议 SP 同时开启增量文件 FTP 接口来接收这种操作，再对用户的订购关系进行处理。 5、对改号操作的说明 WBSERVICE 接口和增量文件 FTP、月全量文件 FTP 接口已经提供改号的操作功能，该点需要 SP 支持该项功能，以便防止用户因改号后，业务不能正常使用的投诉。具体参看附件说明。 6、关于主动上行及主动下行产品的说明 VAC1212 版本升级后，新增了设置产品信任等级功能。对于主动上行、主动下行的产品，在 PRM 录入时，请设置该产品的信任等级为高，SP，业务信任 等级必须为普通。7、针对彩信 SP 业务的 SPIP 填写 对于彩信 SP 业务业务能力信息中 SPIP 在 PRM 的录入，请务必按照如下规范执行： 需至少填写 2 个 IP，1 个上行 IP，1 个下行 IP。下行用于与彩信网关建链使用，只填写 IP 地址；上行 IP 用于状态报告投递（彩信网关投递给 SP） ，填写 IP:PORT。多个IP 地址之间用逗号隔开。 如：，：8080 8、针对彩信 SP 与在信 SP 接入号有重叠（如 10655与 106551）情况的说明。此种情况下，如若短信接入号为短号（10655） ，彩信接入号为长号（106551） ，此时，SP 下发短信时，不能以 106551 为前缀下发短信，可以 10655 下发或 106552、106553 等下发。如以 106551 下发，业务下发不成功。 9、关于 SP 订购关系同步消息的 content 字段填写规则： 1） 、如果是订购，且有二次确认，这个字段填写二次确认消息的内容； 2） 、如果是订购，没有二次确认，这个字段填写订购消息的内容； 3） 、如果是退订，填写退订消息的内容； 4） 、如果对应消息的内容为空，这个字段也填写空； 5） 、在处理订购关系时，没有必要对这个字段做判断；10、针对 sp 订购关系通知采用 SPAP 接口的情况： 填写 SP 订购关系通知 URL 时，需遵从如下规则： SPOrderUrl：填写为 SPMS 的地址，即 11、针对订购业务是否需要二次确认的填写规则： 是否需要 checkPriceConfirm 消息，填写为“否” 。即在如下复选框中选择“否” 。 注意：此处的二次确认不同于“资费的二次明示” ，为用户终端业务最终使用情况的鉴权确认。 12、具体接口规范如下： C: 13、请 SP 注意一下如果一个直接使用类产品或者点播类产品的推广期的结束期大于当前时间，则会出现不能正常扣费的情况，请安排好核查该点。 14、对于彩信 SP 业务，SP 下发彩信的目的 URL 为： 内网：http:/:8080 外网：http:/:8080 调测接口时，先保证能 ping 通上述地址，在发送服务器上可以 telnet 上述端口。 篇三：VAC 与 BSS 接口规范6 中国联通VAC 平台接口技术要求： VAC 与 BSS 接口规范 （暂定名） （） 中国联通公司发布 目 次修改记录 . V 前 言 . X 1 范围 .11 2 规范性引用文件 .11 3 定义与缩略语 .11 定义 . 11 缩略语 . 11 系统边界 . 12 接口原则 . 12 接口约束 . 12 信息更新时机定义 . 12 CP/SP 信息 .13 业务/产品信息 . 13 4 VAC 与 PRM 系统的接口要求 . 13 SP 管理信息同步接口 .13 接口描述 . 13 发起方系统 . 13 接收方系统 . 13 接口协议 . 13 接口内容 . 13 Web Service 接口 .13 FTP 接口 .15 SP 业务能力信息同步接口 .17 接口描述 . 17 发起方系统 . 17 接收方系统 . 17 接口协议 . 17 接口内容 . 18 Web Service 接口 .18 SP 业务能力信息同步请求. 18 业务能力签约结构 .19 FTP 接口 .23 业务信息同步接口 . 25 接口描述 . 25 发起方系统 . 25 接收方系统 . 26 接口协议 . 26 接口内容 . 26 Web Service 接口 .26FTP 接口 .28 5 VAC 与 CRM 系统的接口要求 . 31 产品信息同步接口 . 31 接口描述 . 31 发起方系统 . 31 接收方系统 . 31 接口协议 . 31 接口内容 . 31 Web Service 接口 .31 FTP 接口 .35 用户开户接口(用户级业务能力) . 39 接口描述 . 39 发起方系统 . 39 接收方系统 . 40 接口协议 . 40 接口内容 . 40 用户开户请求（UserRegistReq） . 40 用户开户响应（UserRegistRsp） . 40 UserRegistReq 用户开户请求 FTP 接口 41 用户号段信息同步接口 . 43 接口描述 . 43 发起发系统 . 43 接收方系统 . 43 接口协议 . 43 接口内容 . 43 文件目录 .43 文件命名 .43 请求文件头（定长） .44 回执文件头（定长） .44 请求文件体 .44 回执文件体（变长） .45 用户信息同步接口 . 45 Socket 接口 .45 发起方系统 .45 接收方系统 .45 接口方式 .45 连接方式 .45 包头流水号规则 .46 消息定义 .46 数据类型 .46 消息头 .46 消息体说明 .46 Bind 操作 . 47 Bind 命令的语法 . 47Bind_Resp 应答的语法 .47 Unbind 操作 . 47 Unbind 命令的语法 . 47 Unbind_Resp 应答的语法 .47 User_Info 操作 . 47 User_Info 语法 . 47 User_Info_Resp 语法 .49 链路检测包 KeepAlive 与 KeepAlive _Resp 50 文件方案 . 50 文件目录 .50 文件命名 .50 文件格式 .51 产品订购关系同步接口 . 53 概述 . 53 CRM 发起的业务订购接口 . 53 接口描述 .53 发起方系统 .(转载于: 小 龙文档 网:vac 与 sp 接口规范).53 接收方系统 .54 接口协议 .54 接口内容 .54 VAC 发起的业务订购接口 . 58 接口描述 .58 发起发系统 .58 接收方系统 .58 接口协议 .58 接口内容 .58 资费