短信網(wǎng)關(guān)SP端應(yīng)用程序接口使用詳細說明

1、更多企業(yè)學院：中小企業(yè)管理全能版183套講座+89700份資料總經(jīng)理、高層管理49套講座+16388份資料中層管理學院46套講座+6020份資料國學智慧、易經(jīng)46套講座人力資源學院56套講座+27123份資料各階段員工培訓學院77套講座+ 324份資料員工管理企業(yè)學院67套講座+ 8720份資料工廠生產(chǎn)管理學院52套講座+ 13920份資料財務(wù)管理學院53套講座+ 17945份資料銷售經(jīng)理學院56套講座+ 14350份資料銷售人員培訓學院72套講座+ 4879份資料更多企業(yè)學院：中小企業(yè)管理全能版183套講座+89700份資料總經(jīng)理、高層管理49套講座+16388份資料中層管理學院46套講座+

2、6020份資料國學智慧、易經(jīng)46套講座人力資源學院56套講座+27123份資料各階段員工培訓學院77套講座+ 324份資料員工管理企業(yè)學院67套講座+ 8720份資料工廠生產(chǎn)管理學院52套講座+ 13920份資料財務(wù)管理學院53套講座+ 17945份資料銷售經(jīng)理學院56套講座+ 14350份資料銷售人員培訓學院72套講座+ 4879份資料短信網(wǎng)關(guān)SP端應(yīng)用程序接口使用說明- SXIT_ISMG_CMPP_API一、使用說明本接口遵循 CMPPV2.0協(xié)議標準，以提供消息發(fā)送和接收函數(shù)的方式，向SP提供同移動網(wǎng)關(guān)進行信息交換的實現(xiàn)途徑客戶可以依據(jù)具體需要，利用所提供的函數(shù)實現(xiàn)不同的連接方式(長連

3、接和短連接)以及何時自動建立和中斷連接，除此之外， API作為應(yīng)用的接口，對 CMPP描述的其它功能，象流量控制、重發(fā)機制和并發(fā)處理都不預干預，需要應(yīng)用程序處理。二、函數(shù)說明：1、與網(wǎng)關(guān)建立連接(CMPP_Connect)函數(shù)功能與網(wǎng)關(guān)建立網(wǎng)絡(luò)連接，返回值 0時，標識一個連接，在以下的函數(shù)中使用返回值0連接成功0連接失敗參數(shù)說明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明gwp20字符串網(wǎng)關(guān)的IP地址port4短整型端口號，一般為 7890user name6字符串SP的名稱passwd20字符串密碼注意：username是接入局分配的接入用戶名，而不是企業(yè)代碼。2、向網(wǎng)關(guān)提交信息(CMPP_Submit)函

4、數(shù)功能向網(wǎng)關(guān)提交短信返回值=0標識成功0標識發(fā)送失敗參數(shù)說明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明conn id4整型CMPP Co nn ect 返回的連接標識p msgd8無符號整型消息ID,由網(wǎng)關(guān)返回msg_level1無符號整型消息級別serviced10字符串業(yè)務(wù)代碼msg_format1無符號整型消息格式0: ASCII串 3:短信寫卡操作4 :二進制信息8: UCS2編碼15 :含 GB 漢字。msg src6字符串消息來源(SP ld)fee_type2字符串計費類型01 :對“計費用戶號碼”免費02 :對“計費用戶號碼”按條計信息費03 :對“計費用戶號碼”按包月收取信息費04 :對“

5、計費用戶號碼”的信息費封頂05 :對“計費用戶號碼”的收費是由SP實現(xiàn)fee code6字符串資費代碼，以分為單位valid time14字符串存活時間，格式為 YYYYMMDDHHMISSat time14字符串發(fā)送時間，格式為 YYYYMMDDHHMISStp pid1無符號整型參見GSM03.40, 一般為0udhi1無符號整型參見GSM03.40, 一般為0fee_user_type1無符號整型計費用戶類型0=對目的手機收費， 仁對源手機收費，2=對SP收費，3=對charge num收費charge mobile21字符串收費手機號，沒有寫“ 0”src mobile21字符串源手機

6、號，沒有寫“ 0 “user num1無符號整型接收手機個數(shù) 100dest mobiles21字符串接收手機號碼，以空格分隔msg160字符串消息內(nèi)容msg len4整型消息長度n eed_resp onse1無符號整型是否需要狀態(tài)報告0：不需要1 需2:生成包月話單、八.,、注意:如果建立好連接后一段時間沒有發(fā)送消息，網(wǎng)關(guān)將關(guān)閉連接，CMPP_Submit返回ERROR_SOCKET_CLOSE ，這時，必須重新建立連接并發(fā)送消息3、查詢網(wǎng)關(guān)(CMPP_Query )函數(shù)功能向網(wǎng)關(guān)提交查詢包，并得到查詢結(jié)果。返回值=0 標識成功0 標識失敗 參數(shù)說明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明conn i

7、d4整型連接標識date8字符串日期，格式為yyyymmddtype1無符號整型查詢類型0=查詢總數(shù)，1=按業(yè)務(wù)代碼查詢service10字符串查詢代碼當Query_Type為0時，此項無效；當Query_Type為1時，此項填與業(yè)務(wù)類型Serviced.P resX結(jié)構(gòu)體返回的結(jié)構(gòu)體注意：username是接入局分配的接入用戶名，而不是企業(yè)代碼。4、主動與網(wǎng)關(guān)斷開連接 函數(shù)功能主動和網(wǎng)關(guān)斷開鏈接返回值=0 標識成功0標識成功 返回值標識一個連接，在以下的函數(shù)中使用 0 標識失敗參數(shù)說明：參數(shù)說明:參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明gwp20字符串網(wǎng)關(guān)的IP地址port4短整型端口號，一般為 7910

8、user name6字符串SP的名稱passwd20字符串密碼注意：username是接入局分配的接入用戶名，而不是企業(yè)代碼。6、等待并接收 M0消息函數(shù)功能連接M0虛擬鏈路到網(wǎng)關(guān)返回值=0標識成功 返回值標識一個連接，在以下的函數(shù)中使用 0 標識失敗參數(shù)說明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明Con n id4整型連接標識p MOX結(jié)構(gòu)體返回的MO消息、八.,、注意:如果沒有M0消息將阻塞，直至 M0消息到達或連接被網(wǎng)關(guān)關(guān)閉7、刪除短信(CMPP_Cancel)函數(shù)功能向網(wǎng)關(guān)提交查詢包，并得到查詢結(jié)果。返回值=0 標識成功0 標識失敗參數(shù)說明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明conn id4整型連接標識m

9、sgd8無符號整型消息ID,由網(wǎng)關(guān)返回p_Ca ncel_Rep MsgX結(jié)構(gòu)體返回的刪除短信響應(yīng)結(jié)果8、短連接(以短連接的方式向網(wǎng)關(guān)提交消息，直接調(diào)用即可)函數(shù)功能向網(wǎng)關(guān)提交短信返回值=0 一次連接發(fā)送成功0連接或發(fā)送失敗參數(shù)說明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明gw_ip20字符串網(wǎng)關(guān)的IP地址port4短整型端口號，一般為 7900user name6字符串SP的名稱passwd20字符串密碼p_msgd8無符號整型消息ID,由網(wǎng)關(guān)返回msg_level1無符號整型消息級別serviced10字符串業(yè)務(wù)代碼msg_format1無符號整型消息格式0: ASCII串 3:短信寫卡操作4 :二進制

10、信息8: UCS2編碼15 :含 GB 漢字。msg_src6字符串消息來源(SP ld)fee_type2字符串計費類型01 :對“計費用戶號碼”免費02 :對“計費用戶號碼”按條計信息費03 :對“計費用戶號碼”按包月收取信息費04 :對“計費用戶號碼”的信息費封頂05 :對“計費用戶號碼”的收費是由SP實現(xiàn)fee code6字符串資費代碼，以分為單位valid time14字符串存活時間，格式為 YYYYMMDDHHMISSat time14字符串發(fā)送時間，格式為 YYYYMMDDHHMISStp pid1無符號整型參見GSM03.40, 一般為0udhi1無符號整型參見GSM03.40

11、, 一般為0fee_user_type1無符號整型計費用戶類型0=對目的手機收費， 仁對源手機收費，2=對SP收費，3=對charge num收費charge mobile21字符串收費手機號，沒有寫“ 0”src mobile21字符串源手機號，沒有寫“ 0 “user num1無符號整型接收手機個數(shù) 100dest mobiles21字符串接收手機號碼，以空格分隔msg160字符串消息內(nèi)容msg len4整型消息長度n eed_resp onse1無符號整型是否需要狀態(tài)報告0：不需要1 需2:取消包月9、檢查 MO消息是否是狀態(tài)報告(is_status_report)函數(shù)功能判斷MO包是否

12、為狀態(tài)報告返回值=0 普通MO消息=1 狀態(tài)報告參數(shù)說明：10、從MO消息得到狀態(tài)報告(get_status_report)函數(shù)功能從MO包中得到狀態(tài)報告返回值狀態(tài)報告指針參數(shù)說明參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明p MOX結(jié)構(gòu)體CMPP Get MO得到的結(jié)構(gòu)體11、鏈路檢測(CMPP_Active )函數(shù)功能保持鏈路鏈接正常返回值0 :錯誤=0 :正常參數(shù)說明參數(shù)名數(shù)據(jù)長度1數(shù)據(jù)類型說明Con n id4整型連接標識結(jié)構(gòu)體說明1、查詢結(jié)果結(jié)構(gòu)體(Query_Res):參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明mt total msg4無符號整型:從SP接收的用戶總數(shù)mt total user4無符號整型從SP接收

13、的信息總數(shù)mt succ4無符號整型成功轉(zhuǎn)發(fā)數(shù)量mt wait4無符號整型r待轉(zhuǎn)發(fā)數(shù)量mt fail4無符號整型轉(zhuǎn)發(fā)失敗數(shù)量mo succ4無符號整型向SP成功送達數(shù)量mo wait4無符號整型向SP待送達數(shù)量mo fail4無符號整型向SP送達失敗數(shù)量2、MO消息參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明msgID8整型消息IDdest id21字符串接入號碼serviced10字符串業(yè)務(wù)代碼tp pid1無符號整型見GSM03.40 ,通常為0tp udhi1無符號整型見GSM03.40 ,通常為0msgFormat1無符號整型r消息格式sourceUser21字符串:發(fā)送消息的手機reg deliver

14、1無符號整型是否為應(yīng)答消息，仁yes, 0=nomsgLe n1無符號整型:消息長度msg160字符串消息內(nèi)容3、狀態(tài)報告參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明msgID8整型消息ID,與CMPP_Submit中返回的消息ID對應(yīng)stat7字符串狀態(tài)submit time10字符串提交時間，MMDDHHMMSSdon e time10字符串完成時間，MMDDHHMMSSdestUser21字符串接收手機smsc seq4無符號整型短信中心序列號四、常量說明1狀態(tài)報告中的狀態(tài):常量名說明DELIVRD短信成功傳送EXPIRED超過短信的有效期DELETED短信被刪除UNDELIV短信無法送達ACCEPTD處

15、于被接受狀態(tài)UNKNOWN處于非法狀態(tài)REJECTD處于被拒絕狀態(tài)DELIVRD短信成功傳送2、錯誤碼常量名代表值說明ERROR OK0正常ERROR SOCKET CREATE-100創(chuàng)建socket失敗ERROR CONNECT-101聯(lián)接到網(wǎng)關(guān)失敗ERROR SOCKET WRITE-102寫socket失敗ERROR SOCKET READ-103讀socket失敗ERROR ICP ID-104錯誤的SP IDERROR AUTH-105認證錯誤ERROR MSG LEN-106短消息長度錯ERROR FEE CODE-107計費代碼錯ERROR SERVICE ID-108業(yè)務(wù)代碼

16、錯ERROR FLOW CONTROL-109流量控制錯ERROR SOCKET CLOSE-110當對Socket操作時，socket關(guān)閉ERROR INTERNAL-200內(nèi)部錯誤，一般為信息結(jié)構(gòu)錯ERROR UNKNOWN-201未知錯誤ERROR ARGUMENT-202調(diào)用api函數(shù)參數(shù)錯五、常見問題解答1、 為何聯(lián)接到網(wǎng)關(guān)時網(wǎng)關(guān)回復 ERROR_AUTH錯誤碼？答：深訊網(wǎng)關(guān)在 SP信息里有企業(yè)代碼、SP名稱、密碼三項，網(wǎng)關(guān)要求 SP鑒權(quán)時填寫的用戶名 為局方分配的SP名稱，而不是企業(yè)代碼，密碼為局方分配的SP密碼。2、 為何聯(lián)接到網(wǎng)關(guān)時網(wǎng)關(guān)回復ERROR_SOCKET_READ 錯誤碼？答：造成此問題的原因很可能是你的IP同局方管理人員設(shè)置的IP不一致。請與局方管理人員核對數(shù)據(jù)。3、 為何向網(wǎng)關(guān)提交短信時會返回ERROR_MSG_LEN錯誤碼？答：CMPP2.0協(xié)議有規(guī)定：信息長度當 Msg_Fmt值為0時：160個字節(jié)；其它=140個字節(jié);當你的短信消息長度超長時，網(wǎng)關(guān)