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

1、更多企業(yè)業(yè)學(xué)院：中小企企業(yè)管理理全能版版183套套講座+897700份份資料總經(jīng)理理、高層層管理49套講講座+1163888份資料中層管管理學(xué)院院46套講講座+660200份資料國(guó)學(xué)智智慧、易易經(jīng)46套講講座人力資資源學(xué)院院56套講講座+2271223份資料各階段段員工培培訓(xùn)學(xué)院院77套講講座+ 3244份資料員工管管理企業(yè)業(yè)學(xué)院67套講講座+ 87220份資料工廠生生產(chǎn)管理理學(xué)院52套講講座+ 139920份份資料財(cái)務(wù)管管理學(xué)院院53套講講座+ 179945份份資料銷(xiāo)售經(jīng)經(jīng)理學(xué)院院56套講講座+ 143350份份資料銷(xiāo)售人人員培訓(xùn)訓(xùn)學(xué)院72套講講座+ 48779份資料更多企業(yè)業(yè)學(xué)院：中小企企

2、業(yè)管理理全能版版183套套講座+897700份份資料總經(jīng)理理、高層層管理49套講講座+1163888份資料中層管管理學(xué)院院46套講講座+660200份資料國(guó)學(xué)智智慧、易易經(jīng)46套講講座人力資資源學(xué)院院56套講講座+2271223份資料各階段段員工培培訓(xùn)學(xué)院院77套講講座+ 3244份資料員工管管理企業(yè)業(yè)學(xué)院67套講講座+ 87220份資料工廠生生產(chǎn)管理理學(xué)院52套講講座+ 139920份份資料財(cái)務(wù)管管理學(xué)院院53套講講座+ 179945份份資料銷(xiāo)售經(jīng)經(jīng)理學(xué)院院56套講講座+ 143350份份資料銷(xiāo)售人人員培訓(xùn)訓(xùn)學(xué)院72套講講座+ 48779份資料短信網(wǎng)關(guān)關(guān)SP端端應(yīng)用程程序接口口使用說(shuō)說(shuō)明-

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

4、功能與網(wǎng)關(guān)建建立網(wǎng)絡(luò)絡(luò)連接，返回值值0時(shí)時(shí)，標(biāo)識(shí)識(shí)一個(gè)連連接，在在以下的的函數(shù)中中使用返回值0 連接成成功 0 連接失失敗參數(shù)說(shuō)明明：參數(shù)名數(shù)據(jù)長(zhǎng)度度數(shù)據(jù)類(lèi)型型說(shuō)明gw_iip20字符串網(wǎng)關(guān)的IIP地址址portt4短整型端口號(hào)，一般為為78990userrnamme6字符串SP的名名稱(chēng)passswd20字符串密碼注意：useernaame是是接入局局分配的的接入用用戶(hù)名，而不是是企業(yè)代代碼。2、向網(wǎng)網(wǎng)關(guān)提交交信息 (CMMPP_Subbmitt)函數(shù)功能能向網(wǎng)關(guān)提提交短信信返回值=0 標(biāo)識(shí)識(shí)成功0 標(biāo)識(shí)識(shí)發(fā)送失失敗 參數(shù)數(shù)說(shuō)明：參數(shù)名數(shù)據(jù)長(zhǎng)度度數(shù)據(jù)類(lèi)型型說(shuō)明connn_idd4整型CMPPP

5、_Coonneect 返回回的連接接標(biāo)識(shí)p_mssg_iid8無(wú)符號(hào)整整型消息 IID，由由網(wǎng)關(guān)返返回msg_levvel1無(wú)符號(hào)整整型消息級(jí)別別servvicee_idd10字符串業(yè)務(wù)代碼碼msg_forrmatt1無(wú)符號(hào)整整型消息格式式0：ASSCIII串 3：短短信寫(xiě)卡卡操作4：二進(jìn)進(jìn)制信息息 88：UCCS2編編碼15：含含GB漢漢字。msg_srcc6字符串消息來(lái)源源(SPP_Idd)fee_typpe2字符串計(jì)費(fèi)類(lèi)型型01：對(duì)對(duì)“計(jì)費(fèi)用用戶(hù)號(hào)碼碼”免費(fèi)02：對(duì)對(duì)“計(jì)費(fèi)用用戶(hù)號(hào)碼碼”按條計(jì)計(jì)信息費(fèi)費(fèi)03：對(duì)對(duì)“計(jì)費(fèi)用用戶(hù)號(hào)碼碼”按包月月收取信信息費(fèi)04：對(duì)對(duì)“計(jì)費(fèi)用用戶(hù)號(hào)碼碼”的信息

6、息費(fèi)封頂頂05：對(duì)對(duì)“計(jì)費(fèi)用用戶(hù)號(hào)碼碼”的收費(fèi)費(fèi)是由SSP實(shí)現(xiàn)現(xiàn)fee_codde6字符串資費(fèi)代碼碼，以分分為單位位valiid_ttimee14字符串存活時(shí)間間，格式式為YYYYYMMMDDDHHMMISSSat_ttimee14字符串發(fā)送時(shí)間間，格式式為YYYYYMMMDDDHHMMISSStp_ppid1無(wú)符號(hào)整整型參見(jiàn)GSSM033.400，一般般為0udhii1無(wú)符號(hào)整整型參見(jiàn)GSSM033.400，一般般為0fee_useer_ttypee1無(wú)符號(hào)整整型計(jì)費(fèi)用戶(hù)戶(hù)類(lèi)型0=對(duì)目目的手機(jī)機(jī)收費(fèi)，1=對(duì)對(duì)源手機(jī)機(jī)收費(fèi)，2=對(duì)SSP收費(fèi)費(fèi)，3=對(duì)chhargge_nnum收收費(fèi)charrg

7、e_mobbilee21字符串收費(fèi)手機(jī)機(jī)號(hào)，沒(méi)沒(méi)有寫(xiě)“0”src_mobbilee21字符串源手機(jī)號(hào)號(hào)，沒(méi)有有寫(xiě)“0“userr_nuum1無(wú)符號(hào)整整型接收手機(jī)機(jī)個(gè)數(shù) 1000destt_moobilles21字符串接收手機(jī)機(jī)號(hào)碼，以空格格分隔msg160字符串消息內(nèi)容容msg_lenn4整型消息長(zhǎng)度度needd_reespoonsee1無(wú)符號(hào)整整型是否需要要狀態(tài)報(bào)報(bào)告0：不需需要1：需要要2：生成成包月話話單 注意：如果建建立好連連接后一一段時(shí)間間沒(méi)有發(fā)發(fā)送消息息，網(wǎng)關(guān)關(guān)將關(guān)閉閉連接，CMPPP_Suubmiit返回回ERRROR_SOCCKETT_CLLOSEE ，這這時(shí)，必必須重新新建立

8、連連接并發(fā)發(fā)送消息息3、 查查詢(xún)網(wǎng)關(guān)關(guān)（CMMPP_Queery） 函數(shù)數(shù)功能向網(wǎng)關(guān)提提交查詢(xún)?cè)儼?，并并得到查查?xún)結(jié)果果。返回值=0 標(biāo)識(shí)成成功 0 標(biāo)識(shí)失失敗參數(shù)說(shuō)明明：參數(shù)名數(shù)據(jù)長(zhǎng)度度數(shù)據(jù)類(lèi)型型說(shuō)明connn_idd4整型連接標(biāo)識(shí)識(shí)datee8字符串日期，格格式為yyyyyymmdddtypee1無(wú)符號(hào)整整型查詢(xún)類(lèi)型型0=查查詢(xún)總數(shù)數(shù)，1=按業(yè)務(wù)務(wù)代碼查查詢(xún)servvicee10字符串查詢(xún)代碼碼當(dāng)Queery_Typpe為00時(shí)，此此項(xiàng)無(wú)效效；當(dāng)Queery_Typpe為11時(shí)，此此項(xiàng)填寫(xiě)寫(xiě)業(yè)務(wù)類(lèi)類(lèi)型Seerviice_Id.p_reesX結(jié)構(gòu)體返回的結(jié)結(jié)構(gòu)體注意：useernaame是是

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

10、 返回值值標(biāo)識(shí)一一個(gè)連接接，在以以下的函函數(shù)中使使用0 標(biāo)識(shí)失失敗參數(shù)說(shuō)明明：參數(shù)名數(shù)據(jù)長(zhǎng)度度數(shù)據(jù)類(lèi)型型說(shuō)明Connn_idd4整型連接標(biāo)識(shí)識(shí)p_MOOX結(jié)構(gòu)體返回的MMO消息息注意： 如如果沒(méi)有有MO消消息將阻阻塞，直直至MOO消息到到達(dá)或連連接被網(wǎng)網(wǎng)關(guān)關(guān)閉閉7、 刪刪除短信信（CMMPP_Canncell） 函數(shù)數(shù)功能向網(wǎng)關(guān)提提交查詢(xún)?cè)儼?，并并得到查查?xún)結(jié)果果。返回值=0 標(biāo)識(shí)成成功 0 標(biāo)識(shí)失失敗參數(shù)說(shuō)明明：參數(shù)名數(shù)據(jù)長(zhǎng)度度數(shù)據(jù)類(lèi)型型說(shuō)明connn_idd4整型連接標(biāo)識(shí)識(shí)msg_id8無(wú)符號(hào)整整型消息 IID，由由網(wǎng)關(guān)返返回p_Caanceel_Rep_MsggX結(jié)構(gòu)體返回的刪刪除短信信

11、響應(yīng)結(jié)結(jié)果短連接（以短連連接的方方式向網(wǎng)網(wǎng)關(guān)提交交消息，直接調(diào)調(diào)用即可可）函數(shù)功能能向網(wǎng)關(guān)提提交短信信返回值=0 一次連連接發(fā)送送成功0 連接或或發(fā)送失失敗 參數(shù)數(shù)說(shuō)明：參數(shù)名數(shù)據(jù)長(zhǎng)度度數(shù)據(jù)類(lèi)型型說(shuō)明gw_iip20字符串網(wǎng)關(guān)的IIP地址址portt4短整型端口號(hào)，一般為為79000userrnamme6字符串SP的名名稱(chēng)passswd20字符串密碼p_mssg_iid8無(wú)符號(hào)整整型消息 IID，由由網(wǎng)關(guān)返返回msg_levvel1無(wú)符號(hào)整整型消息級(jí)別別servvicee_idd10字符串業(yè)務(wù)代碼碼msg_forrmatt1無(wú)符號(hào)整整型消息格式式0：ASSCIII串 3：短短信寫(xiě)卡卡操作4：二

12、進(jìn)進(jìn)制信息息 88：UCCS2編編碼15：含含GB漢漢字。msg_srcc6字符串消息來(lái)源源(SPP_Idd)fee_typpe2字符串計(jì)費(fèi)類(lèi)型型01：對(duì)對(duì)“計(jì)費(fèi)用用戶(hù)號(hào)碼碼”免費(fèi)02：對(duì)對(duì)“計(jì)費(fèi)用用戶(hù)號(hào)碼碼”按條計(jì)計(jì)信息費(fèi)費(fèi)03：對(duì)對(duì)“計(jì)費(fèi)用用戶(hù)號(hào)碼碼”按包月月收取信信息費(fèi)04：對(duì)對(duì)“計(jì)費(fèi)用用戶(hù)號(hào)碼碼”的信息息費(fèi)封頂頂05：對(duì)對(duì)“計(jì)費(fèi)用用戶(hù)號(hào)碼碼”的收費(fèi)費(fèi)是由SSP實(shí)現(xiàn)現(xiàn)fee_codde6字符串資費(fèi)代碼碼，以分分為單位位valiid_ttimee14字符串存活時(shí)間間，格式式為YYYYYMMMDDDHHMMISSSat_ttimee14字符串發(fā)送時(shí)間間，格式式為YYYYYMMMDDDHHMM

13、ISSStp_ppid1無(wú)符號(hào)整整型參見(jiàn)GSSM033.400，一般般為0udhii1無(wú)符號(hào)整整型參見(jiàn)GSSM033.400，一般般為0fee_useer_ttypee1無(wú)符號(hào)整整型計(jì)費(fèi)用戶(hù)戶(hù)類(lèi)型0=對(duì)目目的手機(jī)機(jī)收費(fèi)，1=對(duì)對(duì)源手機(jī)機(jī)收費(fèi)，2=對(duì)SSP收費(fèi)費(fèi)，3=對(duì)chhargge_nnum收收費(fèi)charrge_mobbilee21字符串收費(fèi)手機(jī)機(jī)號(hào)，沒(méi)沒(méi)有寫(xiě)“0”src_mobbilee21字符串源手機(jī)號(hào)號(hào)，沒(méi)有有寫(xiě)“0“userr_nuum1無(wú)符號(hào)整整型接收手機(jī)機(jī)個(gè)數(shù) 1000destt_moobilles21字符串接收手機(jī)機(jī)號(hào)碼，以空格格分隔msg160字符串消息內(nèi)容容msg_lenn

14、4整型消息長(zhǎng)度度needd_reespoonsee1無(wú)符號(hào)整整型是否需要要狀態(tài)報(bào)報(bào)告0：不需需要1：需要要2：取消消包月 檢查MOO消息是是否是狀狀態(tài)報(bào)告告（iss_sttatuus_rrepoort） 函數(shù)數(shù)功能判斷MOO包是否否為狀態(tài)態(tài)報(bào)告返回值=0 普通MMO消息息=1 狀態(tài)報(bào)報(bào)告參數(shù)說(shuō)明明：10、從從MO消消息得到到狀態(tài)報(bào)報(bào)告（gget_staatuss_reeporrt） 函數(shù)數(shù)功能從MO包包中得到到狀態(tài)報(bào)報(bào)告返回值狀態(tài)報(bào)告告指針 參數(shù)數(shù)說(shuō)明參數(shù)名數(shù)據(jù)長(zhǎng)度度數(shù)據(jù)類(lèi)型型說(shuō)明p_MOOX結(jié)構(gòu)體CMPPP_Geet_MMO得到到的結(jié)構(gòu)構(gòu)體11、鏈鏈路檢測(cè)測(cè)（CMMPP_Acttivee）

15、函數(shù)數(shù)功能保持鏈路路鏈接正正常返回值0：錯(cuò)錯(cuò)誤=0：正正常 參數(shù)數(shù)說(shuō)明參數(shù)名數(shù)據(jù)長(zhǎng)度度數(shù)據(jù)類(lèi)型型說(shuō)明Connn_idd4整型連接標(biāo)識(shí)識(shí)三、 結(jié)構(gòu)體體說(shuō)明1、查詢(xún)?cè)兘Y(jié)果結(jié)結(jié)構(gòu)體（Queery_Ress）：參數(shù)名數(shù)據(jù)長(zhǎng)度度數(shù)據(jù)類(lèi)型型說(shuō)明mt_ttotaal_mmsg4無(wú)符號(hào)整整型從SP接接收的用用戶(hù)總數(shù)數(shù)mt_ttotaal_uuserr4無(wú)符號(hào)整整型從SP接接收的信信息總數(shù)數(shù)mt_ssuccc4無(wú)符號(hào)整整型成功轉(zhuǎn)發(fā)發(fā)數(shù)量mt_wwaitt4無(wú)符號(hào)整整型待轉(zhuǎn)發(fā)數(shù)數(shù)量mt_ffaill4無(wú)符號(hào)整整型轉(zhuǎn)發(fā)失敗敗數(shù)量mo_ssuccc4無(wú)符號(hào)整整型向SP成成功送達(dá)達(dá)數(shù)量mo_wwaitt4無(wú)符號(hào)整整型向

16、SP待待送達(dá)數(shù)數(shù)量mo_ffaill4無(wú)符號(hào)整整型向SP送送達(dá)失敗敗數(shù)量2、MOO消息參數(shù)名數(shù)據(jù)長(zhǎng)度度數(shù)據(jù)類(lèi)型型說(shuō)明msgIID8整型消息IDDdestt_idd21字符串接入號(hào)碼碼servvicee_idd10字符串業(yè)務(wù)代碼碼tp_ppid1無(wú)符號(hào)整整型見(jiàn)GSMM03.40，通常為為0tp_uudhii1無(wú)符號(hào)整整型見(jiàn)GSMM03.40，通常為為0msgFFormmat1無(wú)符號(hào)整整型消息格式式sourrceUUserr21字符串發(fā)送消息息的手機(jī)機(jī)reg_delliveer1無(wú)符號(hào)整整型是否為應(yīng)應(yīng)答消息息，1=yess，0=nomsgLLen1無(wú)符號(hào)整整型消息長(zhǎng)度度msg160字符串消息內(nèi)容容

17、3、狀態(tài)態(tài)報(bào)告參數(shù)名數(shù)據(jù)長(zhǎng)度度數(shù)據(jù)類(lèi)型型說(shuō)明msgIID8整型消息IDD，與CCMPPP_Suubmiit中返返回的消消息IDD一一對(duì)對(duì)應(yīng)statt7字符串狀態(tài)submmit_timme10字符串提交時(shí)間間，MMMDDHHHMMMSSdonee_tiime10字符串完成時(shí)間間，MMMDDHHHMMMSSdesttUseer21字符串接收手機(jī)機(jī)smscc_seeq4無(wú)符號(hào)整整型短信中心心序列號(hào)號(hào)四、常量量說(shuō)明1、狀態(tài)態(tài)報(bào)告中中的狀態(tài)態(tài)：常量名說(shuō)明DELIIVRDD短信成功功傳送EXPIIREDD超過(guò)短信信的有效效期DELEETEDD短信被刪刪除UNDEELIVV短信無(wú)法法送達(dá)ACCEEPTDD處

18、于被接接受狀態(tài)態(tài)UNKNNOWNN處于非法法狀態(tài)REJEECTDD處于被拒拒絕狀態(tài)態(tài)DELIIVRDD短信成功功傳送2、錯(cuò)誤誤碼常量名代表值說(shuō)明ERROOR_OOK0正常ERROOR_SSOCKKET_CREEATEE-1000創(chuàng)建soockeet失敗敗ERROOR_CCONNNECTT-1011聯(lián)接到網(wǎng)網(wǎng)關(guān)失敗敗ERROOR_SSOCKKET_WRIITE-1022寫(xiě)socckett失敗ERROOR_SSOCKKET_REAAD-1033讀socckett失敗ERROOR_IICP_ID-1044錯(cuò)誤的SSP_IIDERROOR_AAUTHH-1055認(rèn)證錯(cuò)誤誤ERROOR_MMSG_LEN

19、N-1066短消息長(zhǎng)長(zhǎng)度錯(cuò)ERROOR_FFEE_CODDE-1077計(jì)費(fèi)代碼碼錯(cuò)ERROOR_SSERVVICEE_IDD-1088業(yè)務(wù)代碼碼錯(cuò)ERROOR_FFLOWW_COONTRROL-1099流量控制制錯(cuò)ERROOR_SSOCKKET_CLOOSE-1100當(dāng)對(duì)Soockeet操作作時(shí)，ssockket關(guān)關(guān)閉ERROOR_IINTEERNAAL-2000內(nèi)部錯(cuò)誤誤，一般般為信息息結(jié)構(gòu)錯(cuò)錯(cuò)ERROOR_UUNKNNOWNN-2011未知錯(cuò)誤誤ERROOR_AARGUUMENNT-2022調(diào)用appi函數(shù)數(shù)參數(shù)錯(cuò)錯(cuò)五、常見(jiàn)見(jiàn)問(wèn)題解解答1、為何何聯(lián)接到到網(wǎng)關(guān)時(shí)時(shí)網(wǎng)關(guān)回回復(fù)ERRRORR_AUUTH錯(cuò)錯(cuò)誤碼？答：深訊訊網(wǎng)關(guān)在在SP信息息里有企企業(yè)代碼碼、SPP名稱(chēng)、密碼三三項(xiàng)，網(wǎng)網(wǎng)關(guān)要求求SP鑒權(quán)權(quán)時(shí)填寫(xiě)寫(xiě)的用戶(hù)戶(hù)名為局局方分配配的SPP名稱(chēng)，而不是是企業(yè)代代碼，密密碼為局局方分配配的SPP密碼。2、為何何聯(lián)接到到網(wǎng)關(guān)時(shí)時(shí)網(wǎng)關(guān)回回復(fù)ERRRORR_SOOCKEET_RREA