太極GPRS行業(yè)應(yīng)用管理平臺接口_200910

1、 太極GPRS行業(yè)應(yīng)用管理平臺接口說明太極GPRS行業(yè)應(yīng)用管理平臺接口太極計算機股份有限公司2008年4月1 接口說明太極GPRS行業(yè)應(yīng)用管理平臺提供TCP/IP、HTTP/HTTPS XML、WEB SERVICES等方式的接口協(xié)議。本文檔描述了太極GPRS行業(yè)應(yīng)用管理平臺與聯(lián)通綜合營帳系統(tǒng)之間業(yè)務(wù)和管理接口的詳細(xì)定義和說明。聯(lián)通各省的綜合營帳系統(tǒng)可以選擇合適的接口通訊方式與太極GPRS行業(yè)應(yīng)用管理平臺進(jìn)行消息通訊。2 TCP/IP接口2.1 接口描述太極GPRS行業(yè)應(yīng)用管理平臺與綜合營帳系統(tǒng)采用客戶機/服務(wù)器（C/S）模式進(jìn)行通訊，太極GPRS行業(yè)應(yīng)用管理平臺為服務(wù)端，綜合營帳為客戶端。2

2、.2 接口定義通訊雙方采用UDP方式進(jìn)行通訊，通訊端口默認(rèn)為3000，也可采用雙方協(xié)商一致。2.2.1 消息格式定義消息格式由消息頭和消息體組成，消息頭長度固定，消息體采用TLV格式。 消息頭格式定義序號名稱說明長度默認(rèn)值備注1Ver消息版本1字節(jié)0x012Type消息類型1字節(jié)0x003SerialNo消息流水號2字節(jié)營帳系統(tǒng)生成4Result消息執(zhí)行結(jié)果1字節(jié)0x005AttributeNum消息體屬性個數(shù)1字節(jié)根據(jù)實際消息指定 消息體格式定義序號名稱說明長度備注1Type屬性類型1字節(jié)參考屬性類型定義表2Length屬性長度1字節(jié)消息體總長度=2+N（屬性值長

3、度）3Value屬性值N字節(jié)屬性值由屬性字段決定 消息響應(yīng)格式定義消息正常執(zhí)行完成，Server端將消息頭中Result字段值置為0，SerialNo字段與請求消息中SerialNo字段相同，根據(jù)請求的消息類型，可以有，也可以沒有消息體。消息執(zhí)行失敗，Server將消息頭中Result字段置為1，SerialNo字段與請求消息中SerialNo字段相同，消息體有一個屬性。2.2.2 消息定義 新增APN消息類型為1，推薦的消息體附帶的屬性包括：APN、ENT、Status。 修改APN狀態(tài)消息類型為2，推薦的消息體附帶的屬性包括：APN、Status。

4、響應(yīng)消息體附帶的屬性包括：APN、Status。 刪除APN消息類型為3，推薦的消息體附帶的屬性包括：APN。 查詢APN狀態(tài)消息類型為4，推薦的消息體附帶屬性包括：APN。響應(yīng)消息體附帶的屬性包括：APN、Status。 新增單個MDN消息類型為5，推薦的消息體附帶的屬性包括：APN、MDN、Status?？蛇x屬性包括IMSI、Username、Password、IP、IPPool、Band、VisitControl、AccesTime、AccessTime。 新增MDN號段消息類型為6，推薦的消息體附帶的屬性包括：APN、MDN、MD

5、N，Status?？蛇x屬性包括：IMSI、IMSI、Username、Password、IPPool、Status、Band、VisitControl、AccessTime、AccessTime。 刪除MDN消息類型為7，推薦的消息體附帶的屬性包括：APN、MDN。 查詢MDN消息類型為8，推薦的消息體附帶屬性包括：MDN。響應(yīng)消息體附帶的屬性包括：APN、MDN、Status?？蛇x響應(yīng)屬性包括：IMSI、Username、Password、IP、IPPool、AccessTime、AccessTime、Band、VisitControl。 修改MDN

6、消息類型為9，推薦的消息體附帶屬性包括：MDN、Status、APN?？蛇x屬性包括：IMSI、Username、Password。0 修改綁定關(guān)系消息類型為10，推薦的消息體附帶屬性包括：APN、MDN、Band、Username、Password、IMSI、IP。1 修改訪問控制消息類型為11，推薦的消息體附帶屬性包括：APN、MDN、VisitControl、AccessTime、AccessTime。2.2.3 屬性定義屬性名稱屬性編號屬性長度屬性類型備注執(zhí)行結(jié)果11字節(jié)Int0：成功錯誤原因2N字節(jié)CharAPN10N字節(jié)Char企業(yè)名稱ENT11N字節(jié)Ch

7、arMDN1211字節(jié)CharIMSI1315字節(jié)CharAPN狀態(tài)141字節(jié)Int0：正常，1：注銷，2：暫停MDN狀態(tài)151字節(jié)Int0：正常、1：注銷，2：暫停，3：黑名單用戶名16N字節(jié)Char密碼17N字節(jié)Char明文，不加密IP184字節(jié)CharIP地址池19N字節(jié)Char地址池名稱訪問控制201字節(jié)Int0：不控制，1：訪問控制訪問時間218字節(jié)Char00:00:00綁定控制221字節(jié)Int0：不綁定，1：MDN與IMSI綁定，2：MDN與IP綁定，3：MDN與IP綁定，4：MDN與IMSI、IP綁定3 HTTP/HTTPS XML接口3.1.1 接口描述太極GPRS行業(yè)應(yīng)用管

8、理平臺采用HTTP/HTTPS XML接口方式與綜合營帳系統(tǒng)進(jìn)行消息通訊。綜合營帳系統(tǒng)采用HTTP POST方式將XML格式的消息封裝在HTTP Request中發(fā)給太極GPRS行業(yè)應(yīng)用管理平臺，太極GPRS行業(yè)應(yīng)用管理平臺處理完成后，通過HTTP Response返回處理結(jié)果。3.1.2 接口定義太極GPRS行業(yè)應(yīng)用管理平臺的消息接口訪問URL為：http:/IP/gprs/bai/bai.action 請求格式定義消息類型屬性編號屬性體長度屬性值 響應(yīng)格式定義 3.1.3 消息定義參見2.2.2定義。3.1.4 屬性定義參見2.2.3定義。4 Web Services接口4.1 接口描述太極GPRS行業(yè)應(yīng)用管理平臺與綜合營帳可以通過Web Services接口進(jìn)行通訊，WS的URL為：http:/ip:8080/gprs/services/Message4.2 Wsdl定義 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -