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

1、更多企業(yè)學(xué)學(xué)院： 中小企業(yè)業(yè)管理全全能版183套講講座+8897000份資料總經(jīng)理、高高層管理理49套講座座+1663888份資料中層管理理學(xué)院46套講座座+60020份份資料國(guó)學(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份資料財(cái)務(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份份資料國(guó)學(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份資料財(cái)務(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 提提 供供同移動(dòng)動(dòng)網(wǎng)關(guān)進(jìn)進(jìn)行信息息交換的的實(shí)現(xiàn)途途徑.客客戶可以以依據(jù)具具體需要要，利用用所提供供的函數(shù)數(shù)實(shí) 現(xiàn)現(xiàn)不同的的連接方方式(長(zhǎng)長(zhǎng)連接和和短連接接)以及及何時(shí)自自動(dòng)建立立和中斷斷連接， 除此之之外， APII 作作為應(yīng)用用的接口口，對(duì) 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時(shí)，標(biāo)標(biāo)識(shí)一個(gè)個(gè)連接，在在以下的的函數(shù)中中使用返回值0 連連接成功功 0 連連接失敗敗參數(shù)說明：參數(shù)名數(shù)據(jù)長(zhǎng)度數(shù)據(jù)類型說明gw_ipp20字符串網(wǎng)關(guān)的IPP地址port4短整型端口號(hào)，一一般為778900usernnamee6字符串SP的名稱稱passwwd20字符串密碼注意：useernaame是是接入局局分配的的接入用用戶名，而而不是企企業(yè)代碼碼。 2、向網(wǎng)關(guān)關(guān)提交信信息 (CMPPP_SSubmmit)函數(shù)功能向網(wǎng)關(guān)提交交短信返回值=0 標(biāo)識(shí)成成功0 標(biāo)識(shí)發(fā)發(fā)送失敗敗 參數(shù)說說明：參數(shù)名數(shù)據(jù)長(zhǎng)度數(shù)據(jù)類型說明conn_id4整型CMPP

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

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

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

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

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

10、明：參數(shù)名數(shù)據(jù)長(zhǎng)度數(shù)據(jù)類型說明Conn_id4整型連接標(biāo)識(shí)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)提交交查詢包包，并得得到查詢?cè)兘Y(jié)果。返回值=0 標(biāo)標(biāo)識(shí)成功功 0 標(biāo)標(biāo)識(shí)失敗敗參數(shù)說明：參數(shù)名數(shù)據(jù)長(zhǎng)度數(shù)據(jù)類型說明conn_id4整型連接標(biāo)識(shí)msg_iid8無符號(hào)整型型消息 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ù)長(zhǎng)度數(shù)據(jù)類型說明gw_ipp20字符串網(wǎng)關(guān)的IPP地址port4短整型端口號(hào)，一一般為779000usernnamee6字符串SP的名稱稱passwwd20字符串密碼p_msgg_idd8無符號(hào)整型型消息 IDD，由網(wǎng)網(wǎng)關(guān)返回回msg_lleveel1無符號(hào)整型型消息級(jí)別serviice_id10字符串業(yè)務(wù)代碼msg_fformmat1無符號(hào)整型型消息格式0：ASCCII串串 33：短信信寫卡操操作4：二進(jìn)制制信息 8：UCSS2編碼碼15：含GGB漢字字 。msg_ssrc6字符串消息來源(SP_Id)fee_tty

12、pee2字符串計(jì)費(fèi)類型01：對(duì)“計(jì)費(fèi)用用戶號(hào)碼碼”免費(fèi)02：對(duì)“計(jì)費(fèi)用用戶號(hào)碼碼”按條計(jì)計(jì)信息費(fèi)費(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)費(fèi)是由SSP實(shí)現(xiàn)現(xiàn)fee_ccodee6字符串資費(fèi)代碼，以以分為單單位validd_tiime14字符串存活時(shí)間，格格式為YYYYYYMMDDDHHHMISSSat_tiime14字符串發(fā)送時(shí)間，格格式為YYYYYYMMDDDHHHMISSStp_piid1無符號(hào)整型型參見GSMM03.40，一一般為00udhi1無符號(hào)整型型參見GSMM03.40，一一般為00fee_uu

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

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

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

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

17、Sdone_timme10字符串完成時(shí)間，MMMDDDHHMMMSSSdestUUserr21字符串接收手機(jī)smsc_seqq4無符號(hào)整型型短信中心序序列號(hào)四、常量說說明1、狀態(tài)報(bào)報(bào)告中的的狀態(tài)：常量名說明DELIVVRD短信成功傳傳送EXPIRRED超過短信的的有效期期DELETTED短信被刪除除UNDELLIV短信無法送送達(dá)ACCEPPTD處于被接受受狀態(tài)UNKNOOWN處于非法狀狀態(tài)REJECCTD處于被拒絕絕狀態(tài)DELIVVRD短信成功傳傳送2、錯(cuò)誤碼碼常量名代表值說明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錯(cuò)誤的SPP_IDDERRORR_AUUTH-105認(rèn)證錯(cuò)誤ERRORR_MSSG_LLEN-106短消息長(zhǎng)度度錯(cuò)ERRORR_FEEE_CCODEE-107計(jì)費(fèi)代碼錯(cuò)錯(cuò)ERRORR_SEERVIICE_ID-108業(yè)務(wù)代碼錯(cuò)錯(cuò)ERRORR_FLLOW_CONNTROOL-109流量控制錯(cuò)錯(cuò)ERRORR_SOOCKEET_CCLOSSE-110當(dāng)對(duì)Socckett操

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