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

1、更多企業(yè)學(xué)學(xué)院： 中小企業(yè)業(yè)管理全全能版183套講講座+8897000份資料總經(jīng)理、高高層管理理49套講座座+1663888份資料中層管理理學(xué)院46套講座座+60020份份資料國學(xué)智慧慧、易經(jīng)經(jīng)46套講座座人力資源源學(xué)院56套講座座+2771233份資料各階段員員工培訓(xùn)訓(xùn)學(xué)院77套講座座+ 3324份份資料員工管理理企業(yè)學(xué)學(xué)院67套講座座+ 887200份資料工廠生產(chǎn)產(chǎn)管理學(xué)學(xué)院52套講座座+ 1139220份資料財務(wù)管理理學(xué)院53套講座座+ 1179445份資料銷售經(jīng)理理學(xué)院56套講座座+ 1143550份資料銷售人員員培訓(xùn)學(xué)學(xué)院72套講座座+ 448799份資料更多企業(yè)學(xué)學(xué)院： 中小企業(yè)業(yè)

2、管理全全能版183套講講座+8897000份資料總經(jīng)理、高高層管理理49套講座座+1663888份資料中層管理理學(xué)院46套講座座+60020份份資料國學(xué)智慧慧、易經(jīng)經(jīng)46套講座座人力資源源學(xué)院56套講座座+2771233份資料各階段員員工培訓(xùn)訓(xùn)學(xué)院77套講座座+ 3324份份資料員工管理理企業(yè)學(xué)學(xué)院67套講座座+ 887200份資料工廠生產(chǎn)產(chǎn)管理學(xué)學(xué)院52套講座座+ 1139220份資料財務(wù)管理理學(xué)院53套講座座+ 1179445份資料銷售經(jīng)理理學(xué)院56套講座座+ 1143550份資料銷售人員員培訓(xùn)學(xué)學(xué)院72套講座座+ 448799份資料短信網(wǎng)關(guān)SSP端應(yīng)應(yīng)用程序序接口使使用說明明 - SXI

3、IT_IISMGG_CMMPP_APII一、 使使用說明明本接口遵遵循 CCMPPPv2.0 協(xié)協(xié)議標(biāo)準(zhǔn)準(zhǔn)，以提提供消息息發(fā)送和和接收函函數(shù)的方方式， 向 SSP 提提 供供同移動動網(wǎng)關(guān)進(jìn)進(jìn)行信息息交換的的實(shí)現(xiàn)途途徑.客客戶可以以依據(jù)具具體需要要，利用用所提供供的函數(shù)數(shù)實(shí) 現(xiàn)現(xiàn)不同的的連接方方式(長長連接和和短連接接)以及及何時自自動建立立和中斷斷連接， 除此之之外， APII 作作為應(yīng)用用的接口口，對 CMPPP 描描述的其其它功能能，象流流量控制制 、重重發(fā)機(jī)制制和并發(fā)發(fā)處理都都不預(yù) 干干預(yù)，需需要應(yīng)用用程序處處理。 二、 函函數(shù)說明明：1、 與與網(wǎng)關(guān)建建立連接接(CMMPP_Connne

4、cct) 函數(shù)功功能與網(wǎng)關(guān)建立立網(wǎng)絡(luò)連連接，返返回值0時，標(biāo)標(biāo)識一個個連接，在在以下的的函數(shù)中中使用返回值0 連連接成功功 0 連連接失敗敗參數(shù)說明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明gw_ipp20字符串網(wǎng)關(guān)的IPP地址port4短整型端口號，一一般為778900usernnamee6字符串SP的名稱稱passwwd20字符串密碼注意：useernaame是是接入局局分配的的接入用用戶名，而而不是企企業(yè)代碼碼。 2、向網(wǎng)關(guān)關(guān)提交信信息 (CMPPP_SSubmmit)函數(shù)功能向網(wǎng)關(guān)提交交短信返回值=0 標(biāo)識成成功0 標(biāo)識發(fā)發(fā)送失敗敗 參數(shù)說說明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明conn_id4整型CMPP

5、_Connnecct 返回的的連接標(biāo)標(biāo)識p_msgg_idd8無符號整型型消息 IDD，由網(wǎng)網(wǎng)關(guān)返回回msg_lleveel1無符號整型型消息級別serviice_id10字符串業(yè)務(wù)代碼msg_fformmat1無符號整型型消息格式0：ASCCII串串 33：短信信寫卡操操作4：二進(jìn)制制信息 8：UCSS2編碼碼15：含GGB漢字字 。msg_ssrc6字符串消息來源(SP_Id)fee_ttypee2字符串計費(fèi)類型01：對“計費(fèi)用用戶號碼碼”免費(fèi)02：對“計費(fèi)用用戶號碼碼”按條計計信息費(fèi)費(fèi)03：對“計費(fèi)用用戶號碼碼”按包月月收取信信息費(fèi)04：對“計費(fèi)用用戶號碼碼”的信息息費(fèi)封頂頂05：對“計

6、費(fèi)用用戶號碼碼”的收費(fèi)費(fèi)是由SSP實(shí)現(xiàn)現(xiàn)fee_ccodee6字符串資費(fèi)代碼，以以分為單單位validd_tiime14字符串存活時間，格格式為YYYYYYMMDDDHHHMISSSat_tiime14字符串發(fā)送時間，格格式為YYYYYYMMDDDHHHMISSStp_piid1無符號整型型參見GSMM03.40，一一般為00udhi1無符號整型型參見GSMM03.40，一一般為00fee_uuserr_tyype1無符號整型型計費(fèi)用戶類類型0=對目的的手機(jī)收收費(fèi)，11=對源源手機(jī)收收費(fèi)，2=對SPP收費(fèi)，33=對ccharrge_numm收費(fèi)chargge_mmobiile21字符串收費(fèi)手機(jī)

7、號號，沒有有寫“0”src_mmobiile21字符串源手機(jī)號，沒沒有寫“0“user_numm1無符號整型型接收手機(jī)個個數(shù) 1000dest_mobbilees21字符串接收手機(jī)號號碼，以以空格分分隔msg160字符串消息內(nèi)容msg_llen4整型消息長度need_ressponnse1無符號整型型是否需要狀狀態(tài)報告告0：不需要要1：需要2：生成包包月話單單 注意：如果建立立好連接接后一段段時間沒沒有發(fā)送送消息，網(wǎng)網(wǎng)關(guān)將關(guān)關(guān)閉連接接，CMPP_Subbmitt返回EERROOR_SSOCKKET_CLOOSE ，這時時，必須須重新建建立連接接并發(fā)送送消息 3、 查詢詢網(wǎng)關(guān)（CMPP_Quer

8、y） 函數(shù)功功能向網(wǎng)關(guān)提交交查詢包包，并得得到查詢詢結(jié)果。返回值=0 標(biāo)標(biāo)識成功功 0 標(biāo)標(biāo)識失敗敗參數(shù)說明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明conn_id4整型連接標(biāo)識date8字符串日期，格式式為yyyyymmmdddtype1無符號整型型查詢類型00=查詢詢總數(shù)，11=按業(yè)業(yè)務(wù)代碼碼查詢serviice10字符串查詢代碼當(dāng)Querry_TTypee為0時時，此項(xiàng)項(xiàng)無效；當(dāng)Querry_TTypee為1時時，此項(xiàng)項(xiàng)填寫業(yè)業(yè)務(wù)類型型Serrvicce_IId.p_ressX結(jié)構(gòu)體返回的結(jié)構(gòu)構(gòu)體注意：uuserrnamme是接接入局分分配的接接入用戶戶名，而而不是企企業(yè)代碼碼。4、 主動動與網(wǎng)關(guān)關(guān)斷

9、開連連接 函數(shù)功功能主動和網(wǎng)關(guān)關(guān)斷開鏈鏈接返回值=0 標(biāo)標(biāo)識成功功 0 標(biāo)標(biāo)識成功功 返返回值標(biāo)標(biāo)識一個個連接，在在以下的的函數(shù)中中使用0 標(biāo)標(biāo)識失敗敗參數(shù)說明：參數(shù)說明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明gw_ipp20字符串網(wǎng)關(guān)的IPP地址port4短整型端口號，一一般為779100usernnamee6字符串SP的名稱稱passwwd20字符串密碼注意：uuserrnamme是接接入局分分配的接接入用戶戶名，而而不是企企業(yè)代碼碼。 6、等待并并接收 MO 消息 函數(shù)功功能連接MO虛虛擬鏈路路到網(wǎng)關(guān)關(guān)返回值=0 標(biāo)標(biāo)識成功功 返返回值標(biāo)標(biāo)識一個個連接，在在以下的的函數(shù)中中使用0 標(biāo)標(biāo)識失敗敗參數(shù)說

10、明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明Conn_id4整型連接標(biāo)識p_MOX結(jié)構(gòu)體返回的MOO消息注意： 如果果沒有MMO消息息將阻塞塞，直至至MO消消息到達(dá)達(dá)或連接接被網(wǎng)關(guān)關(guān)關(guān)閉7、 刪除除短信（CMPP_Cancel） 函數(shù)功功能向網(wǎng)關(guān)提交交查詢包包，并得得到查詢詢結(jié)果。返回值=0 標(biāo)標(biāo)識成功功 0 標(biāo)標(biāo)識失敗敗參數(shù)說明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明conn_id4整型連接標(biāo)識msg_iid8無符號整型型消息 IDD，由網(wǎng)網(wǎng)關(guān)返回回p_Canncell_Rep_MMsgX結(jié)構(gòu)體返回的刪除除短信響響應(yīng)結(jié)果果短連接（以以短連接接的方式式向網(wǎng)關(guān)關(guān)提交消消息，直直接調(diào)用用即可）函數(shù)功能向網(wǎng)關(guān)提交交短信返回值

11、=0 一一次連接接發(fā)送成成功0 連連接或發(fā)發(fā)送失敗敗 參數(shù)說說明：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明gw_ipp20字符串網(wǎng)關(guān)的IPP地址port4短整型端口號，一一般為779000usernnamee6字符串SP的名稱稱passwwd20字符串密碼p_msgg_idd8無符號整型型消息 IDD，由網(wǎng)網(wǎng)關(guān)返回回msg_lleveel1無符號整型型消息級別serviice_id10字符串業(yè)務(wù)代碼msg_fformmat1無符號整型型消息格式0：ASCCII串串 33：短信信寫卡操操作4：二進(jìn)制制信息 8：UCSS2編碼碼15：含GGB漢字字 。msg_ssrc6字符串消息來源(SP_Id)fee_tty

12、pee2字符串計費(fèi)類型01：對“計費(fèi)用用戶號碼碼”免費(fèi)02：對“計費(fèi)用用戶號碼碼”按條計計信息費(fèi)費(fèi)03：對“計費(fèi)用用戶號碼碼”按包月月收取信信息費(fèi)04：對“計費(fèi)用用戶號碼碼”的信息息費(fèi)封頂頂05：對“計費(fèi)用用戶號碼碼”的收費(fèi)費(fèi)是由SSP實(shí)現(xiàn)現(xiàn)fee_ccodee6字符串資費(fèi)代碼，以以分為單單位validd_tiime14字符串存活時間，格格式為YYYYYYMMDDDHHHMISSSat_tiime14字符串發(fā)送時間，格格式為YYYYYYMMDDDHHHMISSStp_piid1無符號整型型參見GSMM03.40，一一般為00udhi1無符號整型型參見GSMM03.40，一一般為00fee_uu

13、serr_tyype1無符號整型型計費(fèi)用戶類類型0=對目的的手機(jī)收收費(fèi)，11=對源源手機(jī)收收費(fèi)，2=對SPP收費(fèi)，33=對ccharrge_numm收費(fèi)chargge_mmobiile21字符串收費(fèi)手機(jī)號號，沒有有寫“0”src_mmobiile21字符串源手機(jī)號，沒沒有寫“0“user_numm1無符號整型型接收手機(jī)個個數(shù) 1000dest_mobbilees21字符串接收手機(jī)號號碼，以以空格分分隔msg160字符串消息內(nèi)容msg_llen4整型消息長度need_ressponnse1無符號整型型是否需要狀狀態(tài)報告告0：不需要要1：需要2：取消包包月 檢查MO消消息是否否是狀態(tài)態(tài)報告（is_

14、status_report） 函數(shù)功功能判斷MO包包是否為為狀態(tài)報報告返回值=0 普普通MOO消息=1 狀狀態(tài)報告告參數(shù)說明：10、從MMO消息息得到狀狀態(tài)報告告（geet_sstattus_repportt） 函數(shù)功功能從MO包中中得到狀狀態(tài)報告告返回值狀態(tài)報告指指針 參數(shù)說說明參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明p_MOX結(jié)構(gòu)體CMPP_Gett_MOO得到的的結(jié)構(gòu)體體11、鏈路路檢測（CCMPPP_Acctivve） 函數(shù)功功能保持鏈路鏈鏈接正常常返回值0：錯誤誤=0：正常常 參數(shù)說說明參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明Conn_id4整型連接標(biāo)識三、 結(jié)結(jié)構(gòu)體說說明1、查詢結(jié)結(jié)果結(jié)構(gòu)構(gòu)體（QQuerry

15、_RRes）：參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明mt_tootall_mssg4無符號整型型從SP接收收的用戶戶總數(shù)mt_tootall_usser4無符號整型型從SP接收收的信息息總數(shù)mt_suucc4無符號整型型成功轉(zhuǎn)發(fā)數(shù)數(shù)量mt_waait4無符號整型型待轉(zhuǎn)發(fā)數(shù)量量mt_faail4無符號整型型轉(zhuǎn)發(fā)失敗數(shù)數(shù)量mo_suucc4無符號整型型向SP成功功送達(dá)數(shù)數(shù)量mo_waait4無符號整型型向SP待送送達(dá)數(shù)量量mo_faail4無符號整型型向SP送達(dá)達(dá)失敗數(shù)數(shù)量2、MO消消息參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明msgIDD8整型消息IDdest_id21字符串接入號碼serviice_id10字符串業(yè)務(wù)代碼

16、tp_piid1無符號整型型見GSM003.440，通通常為00tp_uddhi1無符號整型型見GSM003.440，通通常為00msgFoormaat1無符號整型型消息格式sourcceUsser21字符串發(fā)送消息的的手機(jī)reg_ddeliiverr1無符號整型型是否為應(yīng)答答消息，11=yees，00=noomsgLeen1無符號整型型消息長度msg160字符串消息內(nèi)容3、狀態(tài)報報告參數(shù)名數(shù)據(jù)長度數(shù)據(jù)類型說明msgIDD8整型消息ID，與與CMPPP_SSubmmit中中返回的的消息IID一一一對應(yīng)stat7字符串狀態(tài)submiit_ttimee10字符串提交時間，MMMDDDHHMMMSS

17、Sdone_timme10字符串完成時間，MMMDDDHHMMMSSSdestUUserr21字符串接收手機(jī)smsc_seqq4無符號整型型短信中心序序列號四、常量說說明1、狀態(tài)報報告中的的狀態(tài)：常量名說明DELIVVRD短信成功傳傳送EXPIRRED超過短信的的有效期期DELETTED短信被刪除除UNDELLIV短信無法送送達(dá)ACCEPPTD處于被接受受狀態(tài)UNKNOOWN處于非法狀狀態(tài)REJECCTD處于被拒絕絕狀態(tài)DELIVVRD短信成功傳傳送2、錯誤碼碼常量名代表值說明ERRORR_OKK0正常ERRORR_SOOCKEET_CCREAATE-100創(chuàng)建socckett失敗ERRORR

18、_COONNEECT-101聯(lián)接到網(wǎng)關(guān)關(guān)失敗ERRORR_SOOCKEET_WWRITTE-102寫sockket失失敗ERRORR_SOOCKEET_RREADD-103讀sockket失失敗ERRORR_ICCP_IID-104錯誤的SPP_IDDERRORR_AUUTH-105認(rèn)證錯誤ERRORR_MSSG_LLEN-106短消息長度度錯ERRORR_FEEE_CCODEE-107計費(fèi)代碼錯錯ERRORR_SEERVIICE_ID-108業(yè)務(wù)代碼錯錯ERRORR_FLLOW_CONNTROOL-109流量控制錯錯ERRORR_SOOCKEET_CCLOSSE-110當(dāng)對Socckett操

19、作時時，soockeet關(guān)閉閉ERRORR_INNTERRNALL-200內(nèi)部錯誤，一一般為信信息結(jié)構(gòu)構(gòu)錯ERRORR_UNNKNOOWN-201未知錯誤ERRORR_ARRGUMMENTT-202調(diào)用apii函數(shù)參參數(shù)錯五、常見問問題解答答1、為何聯(lián)聯(lián)接到網(wǎng)網(wǎng)關(guān)時網(wǎng)網(wǎng)關(guān)回復(fù)復(fù)ERRROR_AUTTH 錯誤碼碼？答：深訊網(wǎng)網(wǎng)關(guān)在SP信息息里有企企業(yè)代碼碼、SPP名稱、密密碼三項(xiàng)項(xiàng)，網(wǎng)關(guān)關(guān)要求SSP鑒權(quán)權(quán)時填寫寫的用戶戶名為局局方分配配的SPP名稱，而而不是企企業(yè)代碼碼，密碼碼為局方方分配的的SP密碼碼。2、為何聯(lián)聯(lián)接到網(wǎng)網(wǎng)關(guān)時網(wǎng)網(wǎng)關(guān)回復(fù)復(fù)ERRROR_SOCCKETT_REEAD錯錯誤碼？答：造成此此問題的的原因很很可能是是你的IIP同局局方管理理人員設(shè)設(shè)置的IIP不一一致。請請與局方方管理人人員核對對數(shù)據(jù)。3、為何向向網(wǎng)關(guān)提提交短信信時會返返回ERRRORR_MSSG_LLEN錯錯誤碼？答：CMPPP2.0