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

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

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

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

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

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

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

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

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

9、sgd8無符號(hào)整型消息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短整型端口號(hào)，一般為 7900user name6字符串SP的名稱passwd20字符串密碼p_msgd8無符號(hào)整型消息ID,由網(wǎng)關(guān)返回msg_level1無符號(hào)整型消息級(jí)別serviced10字符串業(yè)務(wù)代碼msg_format1無符號(hào)整型消息格式0: ASCII串 3:短信寫卡操作4 :二進(jìn)制

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

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

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

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

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

15、于被接受狀態(tài)UNKNOWN處于非法狀態(tài)REJECTD處于被拒絕狀態(tài)DELIVRD短信成功傳送2、錯(cuò)誤碼常量名代表值說明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錯(cuò)誤的SP IDERROR AUTH-105認(rèn)證錯(cuò)誤ERROR MSG LEN-106短消息長度錯(cuò)ERROR FEE CODE-107計(jì)費(fèi)代碼錯(cuò)ERROR SERVICE ID-108業(yè)務(wù)代碼

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