太极GPRS行业应用管理平台接口-200910

太极GPRS行业应用管理平台接口说明太极GPRS行业应用管理平台接口太极计算机股份有限公司2008年4月1 接口说明太极GPRS行业应用管理平台提供TCP/IP、HTTP/HTTPS XML、WEB SERVICES等方式的接口协议。本文档描述了太极GPRS行业应用管理平台与联通综合营帐系统之间业务和管理接口的详细定义和说明。联通各省的综合营帐系统可以选择合适的接口通讯方式与太极GPRS行业应用管理平台进行消息通讯。2 TCP/IP接口2.1 接口描述太极GPRS行业应用管理平台与综合营帐系统采用客户机/服务器（C/S）模式进行通讯，太极GPRS行业应用管理平台为服务端，综合营帐为客户端。2.2 接口定义通讯双方采用UDP方式进行通讯，通讯端口默认为3000，也可采用双方协商一致。2.2.1 消息格式定义消息格式由消息头和消息体组成，消息头长度固定，消息体采用TLV格式。 消息头格式定义序号名称说明长度默认值备注1Ver消息版本1字节0x012Type消息类型1字节0x003SerialNo消息流水号2字节营帐系统生成4Result消息执行结果1字节0x005AttributeNum消息体属性个数1字节根据实际消息指定 消息体格式定义序号名称说明长度备注1Type属性类型1字节参考属性类型定义表2Length属性长度1字节消息体总长度=2+N（属性值长度）3Value属性值N字节属性值由属性字段决定 消息响应格式定义消息正常执行完成，Server端将消息头中Result字段值置为0，SerialNo字段与请求消息中SerialNo字段相同，根据请求的消息类型，可以有，也可以没有消息体。消息执行失败，Server将消息头中Result字段置为1，SerialNo字段与请求消息中SerialNo字段相同，消息体有一个属性。2.2.2 消息定义 新增APN消息类型为1，推荐的消息体附带的属性包括：APN、ENT、Status。 修改APN状态消息类型为2，推荐的消息体附带的属性包括：APN、Status。响应消息体附带的属性包括：APN、Status。 删除APN消息类型为3，推荐的消息体附带的属性包括：APN。 查询APN状态消息类型为4，推荐的消息体附带属性包括：APN。响应消息体附带的属性包括：APN、Status。 新增单个MDN消息类型为5，推荐的消息体附带的属性包括：APN、MDN、Status。可选属性包括IMSI、Username、Password、IP、IPPool、Band、VisitControl、AccesTime、AccessTime。 新增MDN号段消息类型为6，推荐的消息体附带的属性包括：APN、MDN、MDN，Status。可选属性包括：IMSI、IMSI、Username、Password、IPPool、Status、Band、VisitControl、AccessTime、AccessTime。 删除MDN消息类型为7，推荐的消息体附带的属性包括：APN、MDN。 查询MDN消息类型为8，推荐的消息体附带属性包括：MDN。响应消息体附带的属性包括：APN、MDN、Status。可选响应属性包括：IMSI、Username、Password、IP、IPPool、AccessTime、AccessTime、Band、VisitControl。 修改MDN消息类型为9，推荐的消息体附带属性包括：MDN、Status、APN。可选属性包括：IMSI、Username、Password。0 修改绑定关系消息类型为10，推荐的消息体附带属性包括：APN、MDN、Band、Username、Password、IMSI、IP。1 修改访问控制消息类型为11，推荐的消息体附带属性包括：APN、MDN、VisitControl、AccessTime、AccessTime。2.2.3 属性定义属性名称属性编号属性长度属性类型备注执行结果11字节Int0：成功错误原因2N字节CharAPN10N字节Char企业名称ENT11N字节CharMDN1211字节CharIMSI1315字节CharAPN状态141字节Int0：正常，1：注销，2：暂停MDN状态151字节Int0：正常、1：注销，2：暂停，3：黑名单用户名16N字节Char密码17N字节Char明文，不加密IP184字节CharIP地址池19N字节Char地址池名称访问控制201字节Int0：不控制，1：访问控制访问时间218字节Char00:00:00绑定控制221字节Int0：不绑定，1：MDN与IMSI绑定，2：MDN与IP绑定，3：MDN与IP绑定，4：MDN与IMSI、IP绑定3 HTTP/HTTPS XML接口3.1.1 接口描述太极GPRS行业应用管理平台采用HTTP/HTTPS XML接口方式与综合营帐系统进行消息通讯。综合营帐系统采用HTTP POST方式将XML格式的消息封装在HTTP Request中发给太极GPRS行业应用管理平台，太极GPRS行业应用管理平台处理完成后，通过HTTP Response返回处理结果。3.1.2 接口定义太极GPRS行业应用管理平台的消息接口访问URL为：http:/IP/gprs/bai/bai.action 请求格式定义消息类型属性编号属性体长度属性值 响应格式定义 3.1.3 消息定义参见2.2.2定义。3.1.4 属性定义参见2.2.3定义。4 Web Services接口4.1 接口描述太极GPRS行业应用管理平台与综合营帐可以通过Web Services接口进行通讯，WS的URL为：http:/ip:8080/gprs/services/Message4.2 Wsdl定义 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -