【正文】 當(dāng)參數(shù) nMsgFormat 等于 0 或 15 時， API 就提供分割短消息功能。 ? 參數(shù) 參數(shù)名 數(shù)據(jù)類型 說明 sMsgIDFile Char(100) 保存所有短消息的返回 MsgID和 ErrorCode 的文件名 nPos Int 短消息位置，從 0開始 pSendBatchResp SendBatchResp * 用于保存結(jié)果的 SendBatchResp 結(jié)構(gòu)指針 ? 返回 0=成功 1=失敗 接收短信（ SMGPDeliver） ? 作用 基于 固定 電話網(wǎng)的信息終端及綜合 信息系統(tǒng) 技術(shù)規(guī)范 第七分冊 第 25頁 連接短信網(wǎng)關(guān)，等待接收屬于本 ICP 的短信。短消息長度最長為 200， SMGP API 在發(fā)送時自動建立 Connection Pool，采用長連接或者短連接發(fā)送短消息。 例子程序 網(wǎng)關(guān)至少應(yīng)該提供以下例程，供 ICP 調(diào)試使用，分別為： ? Connect(參數(shù) )，檢查是否能夠成功登錄短消息網(wǎng)關(guān)； ? TestAPI（參數(shù)），檢查是否能夠成功連接短信網(wǎng)關(guān)。 請求名稱 請求標(biāo)識 說明 login 0x00000001 CP 或 SMGW 登錄請求 login_resp 0x80000001 CP 或 SMGW 登錄回應(yīng) submit 0x00000002 CP 發(fā)送短消息請求 submit_resp 0x80000002 CP 發(fā)送短消息回應(yīng) deliver 0x00000003 SMGW 向 CP 發(fā)送短消息請求 deliver_resp 0x80000003 SMGW 向 CP 發(fā)送短消息回應(yīng) active_test 0x00000004 測試通信鏈路是否正常請求（由客戶端發(fā)起，CP 和 SMGW可以通過 定時發(fā)送此請求來維持連接） active_test_resp 0x80000004 測試通信鏈路是否正?；貞?yīng) forward 0x00000005 SMGW 轉(zhuǎn)發(fā) MT/MO 短消息請求 forward_reCP 0x80000005 SMGW 轉(zhuǎn)發(fā) MT/MO 短消息回應(yīng) exit 0x00000006 退出請求 exit_resp 0x80000006 退出回應(yīng) query 0x00000007 CP 統(tǒng)計查詢請求 query_resp 0x80000007 CP 統(tǒng)計查詢回應(yīng) mt_route_update 0x00000008 MT 路由更新請求 mt_route_update_resp 0x80000008 MT 路由更新回應(yīng) mo_route_update 0x00000009 MO路由更新請求 mo_route_update_resp 0x80000009 MO路由更新回應(yīng) . 包體結(jié)構(gòu) . login 字段 長度 數(shù)據(jù)類型 說明 8 Octet CP編號或者 SMGW 編號 1 1 編號不足 8 位 時則右對齊，左補(bǔ) ASCII0（ 0x30），例如 021061，添兩位零得 00021061。內(nèi)容提供商與短消息網(wǎng)關(guān)或者短消息網(wǎng)關(guān)與短消息網(wǎng)關(guān)之間采用 Client/Server 方式交互信息，客戶端向服 務(wù)器端發(fā)送一個請求包，服務(wù)器端向客戶端返回回應(yīng)包。 2 引用標(biāo)準(zhǔn) SMPP (Short Message Peer to Peer Protocol Specification) 3 縮略語 見總冊 4 SMGP 概述 . SMGP 功能 SMGP 協(xié)議是內(nèi)容提供商與短消息網(wǎng)關(guān)，以及短消息網(wǎng)關(guān)與短消息網(wǎng)關(guān)之間的通信協(xié)議。 . CP 發(fā)送短消息 CP 以發(fā)送者或者是收發(fā)者身份登錄后，就可以發(fā)送短消息。 submit date:YYMMDDhhmm done date: YYMMDDhhmm stat:DDDDDDD。代碼含義：非狀態(tài)報告（ 0）；狀態(tài)報告（ 1） NMsgLen Int 消息長度 sMsgContent Char(20xx53) 消息內(nèi)容 sDestTermID Char(2122) CP 的接入代碼 sRecvTime char(15) 短消息接收時間（格式： yyyymmddhhmiss，例如 20xx030120xx00） sReserved Char(9) 保留 獲取群發(fā)短信的返回數(shù)據(jù)結(jié)構(gòu)（ SendBatchResp） ? 用途 使用 SMGPSendBatch 群發(fā)短信后，每條短信的“消息標(biāo)識”和“錯誤代碼”保存在文件里。 SMGP API 在發(fā)送時自動建立 Connection Pool，采用 長連接或者短連接發(fā)送短消息。 例如（第 2個分割短消息）： (2/3)(continue)xxxxxx “(continue)”是前置說明文字 WithNextPage 分割短消息的后置說明文字，可以為空，最后一個短消息不帶后置說明文字。如果發(fā)現(xiàn)中文，就自動把發(fā)送格式變?yōu)?15。 CPShareKey CP 密碼。 sMsgType Char(2) 短消息類型 sReserved Char(9) 保留 ? 返回 0=成功 1=失敗 群發(fā)短信（ SMGPSendBatch） ? 作用 向短消息網(wǎng)關(guān)發(fā)送 1 條短消息到多個手機(jī)用戶。網(wǎng)關(guān)不做判定 , 透明傳輸。 3 對于狀態(tài)報告， MsgType 取 0。在發(fā)送模式中客戶端只能發(fā)送短消息、在接收模式中客戶端只能接收短消息、在收發(fā)模式中客戶端既可以發(fā)送也可以接收短消息。 本標(biāo)準(zhǔn)起草單位： 中國電信集團(tuán)公司、中國電信集團(tuán)公司上 海研發(fā)中心 本標(biāo)準(zhǔn)主要起草人： 特別感謝：亞信科技中國有限公司在本協(xié)議制訂過程中的大力支持和幫助。 客戶端和服務(wù)器端之間可以采用長連接或者短連接的方式通信。 AuthenticatorClient 16 Octet String 客戶端密碼 用于鑒別客戶端的接入請求。 ? SendSM（參數(shù)）嘗試發(fā)送短信。如果應(yīng)用程序采用多線程發(fā)送短消息，多個線程共享同一個 Connection Pool。 0表示永遠(yuǎn)等待。如果某一段短消息含有中文，就把那一段短消息的發(fā)送格式設(shè)為 15，取PageSpaceGB 為最大長度；如果不含中文，就把那一段短消息的發(fā)送格式設(shè)為 0，取 PageSpaceAscii 為最大長度。如果客戶主機(jī)的 IP 地址填寫錯誤會導(dǎo)致 應(yīng)用程序不能通過 SMGP用戶認(rèn)證。網(wǎng)關(guān)不做判定 , 透明傳輸。 如果應(yīng)用程序的執(zhí)行目錄不在 smgpapi/bin 下，就需要通過絕對或相對路徑指定 sINIFile。 . Status 錯誤代碼表 代碼 含義 0 成功 1 系統(tǒng)忙 2 超過最大連接數(shù) 39 保留 10 消息結(jié)構(gòu)錯 11 命令字錯 12 序列號重復(fù) 1319 保留 20 IP 地址錯 21 認(rèn)證錯 22 版本 太高 2329 保留 30 非法消息類型（ MsgType） 31 非法優(yōu)先級（ Priority） 32 非法資費(fèi)類型（ FeeType） 基于 固定 電話網(wǎng)的信息終端及綜合 信息系統(tǒng) 技術(shù)規(guī)范 第七分冊 第 18頁 33 非法資費(fèi)代碼（ FeeCode） 34 非法短消息格式（ MsgFormat） 35 非法時間格式 36 非法短消息長度（ MsgLength） 37 有效期已過 38 非法查詢類別（ QueryType） 39 路由錯誤 40 非法包月費(fèi) /封頂費(fèi)（ FixedFee） 41 非法更新類型（ UpdateType） 42 非法路由編號（ RouteId） 43 非法服務(wù)代碼（ ServiceId） 44 非法有效期（ ValidTime） 45 非法定時發(fā)送時間（ AtTime） 46 非法發(fā)送用戶號碼（ SrcTermId） 47 非法接收用戶號碼（ DestTermId） 48 非法計費(fèi)用戶號碼（ ChargeTermId） 49 非法 CP 代碼 50127 保留 128255 廠家自定義 7 基于 SMGP協(xié)議的 API函數(shù) 詳見附錄 A。位數(shù)不足時， 則左對齊，右補(bǔ) 0x00如果左補(bǔ)‘ 0’則補(bǔ) ASCII 表示的‘ 0’，如 果右補(bǔ)‘ 0’則補(bǔ)二進(jìn)制表示的‘ 0’ . 數(shù)據(jù)包結(jié)構(gòu) SMGP 數(shù)據(jù)包分為包頭和包體兩部分，包頭的結(jié)構(gòu)如下： 字段 長度（字節(jié)） 數(shù)據(jù)類型 說明 PacketLength 4 Integer 數(shù)據(jù)包長度（包頭和包體的長度之和。 . SMGP 定義 SMGP協(xié)議是一個基于數(shù)據(jù)包的交互式協(xié)議，底層通過 TCP/IP協(xié)議傳遞數(shù)據(jù)。 (2) 綜合信息系統(tǒng)短消息用戶向內(nèi)容提供商點播信息，例如股票查詢、航班信息等。 基于 固定 電話網(wǎng)的信息終端及綜合 信息系統(tǒng) 技術(shù)規(guī)范 第七分冊 第 5頁 CP SMGW login(send /transmit mode) login_resp submit(1) submit(2) submit_resp (1) submit_resp (2) exit exit_resp . CP 接收短消息 CP 以接收者 或者是收發(fā)者 身份登錄后，短消息網(wǎng)關(guān)就向 CP 發(fā)送 短消息，短消息網(wǎng)關(guān)可以不等待上一個短消息回應(yīng)包，就發(fā)送下一個短消 息。 Text:…… ”。 ? 字段說明 字段 名 數(shù)據(jù)類型 說明 sMsgID Char(1121) 短消息標(biāo)識 nErrorCode Int 錯誤代碼（參照錯誤代碼表） 基于 固定 電話網(wǎng)的信息終端及綜合 信息系統(tǒng) 技術(shù)規(guī)范 第七分冊 第 21頁 sPhoneNo Char(22) 發(fā)送號碼 查詢短消息網(wǎng)關(guān)的返回數(shù)據(jù)結(jié)構(gòu)（ QueryResp 可選） ? 用途 保存 SMGPQuery 函數(shù)返回的查詢結(jié)果。如果應(yīng)用程序采用多線程發(fā)送短消息，多個線程共享同一個 Connection Pool。 MaxPage 最大分割頁數(shù)，最大是 99頁。 當(dāng)參數(shù) nMs