******************************************************************************************

    廈門商州數(shù)碼公司作為移動(dòng)夢(mèng)網(wǎng)的SP合作伙伴，現(xiàn)向大家免費(fèi)開(kāi)放網(wǎng)關(guān)接口及其開(kāi)發(fā)源代碼。

我們將熱情的期盼與您的合作，您可以開(kāi)發(fā)各種短信的應(yīng)用，或在你的項(xiàng)目中加入短信收發(fā)功能，

同時(shí)我們也可以一起合作在您的網(wǎng)站上加入集團(tuán)短信、圖片、鈴聲等各種功能，我們將向你提供完善

的技術(shù)支持。

    如果您有新的項(xiàng)目需要一個(gè)特服號(hào)進(jìn)行短信收發(fā)時(shí)，我們將有嘗的提供一個(gè)特服號(hào)(9160331XXX)，

及提供短信的增值收費(fèi)。


*******************************************************************************************

接口標(biāo)準(zhǔn)：
客戶端通過(guò)Tcp連接到服務(wù)器（211.162.36.89:8021, IP可能會(huì)變動(dòng)，變動(dòng)時(shí)，以www.pohoo.com網(wǎng)站公布的為準(zhǔn)）。
連接成功后客戶端應(yīng)首先發(fā)送注冊(cè)串為：
Login Name=【注冊(cè)名】&Pwd=【注冊(cè)密碼】&Type=【注冊(cè)類型，0：接收和發(fā)送；1：接收；2：發(fā)送；默認(rèn)為0】（回車換行）
	注：強(qiáng)烈建議使用Type=0的模式。
如果所有服務(wù)注冊(cè)成功，服務(wù)器返回給客戶端字符串：
Pass（回車換行）
否則將斷開(kāi)連接。

指令集：
  1：分發(fā)中心向服務(wù)方發(fā)送用戶的短信請(qǐng)求，格式如下：
  
	分發(fā)中心==>Deliver 
	CommandId=【命令標(biāo)識(shí)，4字節(jié)整型，循環(huán)使用】
	&GateName=【源網(wǎng)關(guān)名】
	&ItemId=【節(jié)目標(biāo)識(shí)】
	&UserNumber=【用戶號(hào)碼】
	&SpNumber=【服務(wù)號(hào)碼，必須以9160開(kāi)頭】
	&MsgCode=【短信編碼，0：ASCII串；3：短信寫(xiě)卡操作；4：二進(jìn)制信息；8：UCS2編碼；15：含GB漢字；
		24：UCS2編碼閃電短信(Msg<=69個(gè)漢字)，124：GBK編碼閃電短信(Msg<=69個(gè)漢字)】
	&Msg:=【短信內(nèi)容，經(jīng)加碼處理，需解碼】
	（回車換行）
	
	回應(yīng)：Received CommandId=【對(duì)應(yīng)于發(fā)送時(shí)的命令標(biāo)識(shí)】（回車換行）
	
  2：服務(wù)方向分發(fā)中心提交發(fā)送內(nèi)容，格式如下：
  
  	服務(wù)方==>Submit （空格）
	CommandId=【命令標(biāo)識(shí)，4字節(jié)整型，循環(huán)使用】
	&GateName=【目的網(wǎng)關(guān)名】，默認(rèn)由分發(fā)中心根據(jù)手機(jī)號(hào)碼決定目的網(wǎng)關(guān)名】
  	&ItemId=【節(jié)目標(biāo)識(shí)】
  	&SpNumber=【服務(wù)號(hào)碼，以9160開(kāi)頭】
  	&UserNumber=【目的用戶號(hào)碼，如果是群發(fā)將個(gè)號(hào)碼之間用“,”隔開(kāi)，注意最多只能有255個(gè)群發(fā)號(hào)碼】
  	&FeeNumber=【計(jì)費(fèi)號(hào)碼，短信產(chǎn)生的費(fèi)用由該號(hào)碼承擔(dān)，不填時(shí)默認(rèn)向目的用戶號(hào)碼收費(fèi)】
  	&FeeType=【計(jì)費(fèi)類型，1：免費(fèi)，需申請(qǐng)，2：按條計(jì)費(fèi)，3：定制包月計(jì)費(fèi)(同時(shí)要求ReportFlag=2)。默認(rèn)：2】
  	&ScheduleTime=【定時(shí)發(fā)送時(shí)間，默認(rèn)立即發(fā)送，格式舉例：2002年09月10日20:08:00為：020910200800】
  	&ExpireTime=【短信壽命中止時(shí)間，格式舉例：021201090508，默認(rèn)為移動(dòng)或聯(lián)通（24小時(shí)后）中止時(shí)間】
  	&MtFlag=【*引起MT消息的原因，僅當(dāng)向聯(lián)通用戶發(fā)短信時(shí)需要該參數(shù)，0-MO點(diǎn)播引起的第一條MT消息；1-MO點(diǎn)播引起的非第一條MT消息；
  		2-非MO點(diǎn)播引起的MT消息；3-系統(tǒng)反饋引起的MT消息。默認(rèn)為0】
  	&ReportFlag=【狀態(tài)報(bào)告標(biāo)志，0：不需要	狀態(tài)報(bào)告；1：無(wú)論成功與否都返回狀態(tài)報(bào)告；2：該條消息僅攜帶包月計(jì)費(fèi)信息，不下發(fā)給用戶；
  		3：只有最后出錯(cuò)時(shí)要返回狀態(tài)報(bào)告，默認(rèn)：0】
  		注：在每次包月定制計(jì)費(fèi)時(shí)都需發(fā)送一條內(nèi)容為空串，ReportFlag=2，F(xiàn)eeType=3的記錄，該短信不會(huì)下發(fā)給用戶，僅用于告知網(wǎng)關(guān)向
  		該用戶收取包月費(fèi)用，在用戶沒(méi)有取消定制的情況下每月必須且只能發(fā)送一次。
  	&MsgCode=【短信編碼，0：ASCII串；3：短信寫(xiě)卡操作；4：二進(jìn)制信息；8：UCS2編碼；15：含GB漢字；
		24：UCS2編碼閃電短信(Msg<=69個(gè)漢字)，124：GBK編碼閃電短信(Msg<=69個(gè)漢字)】
  	&MsgId=【用戶自定義消息標(biāo)識(shí)，推薦格式：年月日時(shí)分秒＋6位自遞增碼，例如：9月23日10:00:03發(fā)出的序號(hào)為1記錄可定義為
  		923100003000001。自定義格式最大不超過(guò)20個(gè)字符且不能有需加碼解碼的特殊字符】
  	&ExtData:=【短信擴(kuò)展數(shù)據(jù)，服務(wù)方短信發(fā)送的附加信息，在有報(bào)告反饋時(shí)會(huì)連帶該擴(kuò)展數(shù)據(jù)反饋給服務(wù)方，需加碼處理，但加碼后不能超過(guò)
  		120個(gè)字節(jié)長(zhǎng)度。默認(rèn)為空串】
  	&TP_pId=【GSM協(xié)議類型。詳細(xì)解釋請(qǐng)參考GSM0	3.40中的9.2.3.9】
  	&TP_udhi=【GSM協(xié)議類型。詳細(xì)解釋請(qǐng)參考GSM03.40中的9.2.3.23,僅使用1位，右對(duì)齊】
  	&Msg:=【短信內(nèi)容，需加碼處理】
  	（回車換行）
  	
	回應(yīng)：Received CommandId=【對(duì)應(yīng)于發(fā)送時(shí)的命令標(biāo)識(shí)】（回車換行）
	
  3：分發(fā)中心向服務(wù)方發(fā)送報(bào)告，格式如下：
  
  	分發(fā)中心==>Report 
	CommandId=【命令標(biāo)識(shí)，4字節(jié)整型，循環(huán)使用】
	&GateName=【源網(wǎng)關(guān)名】
  	&MsgId=【服務(wù)方在Submit時(shí)寫(xiě)在MsgId參數(shù)中的值】
  	&ExtData=【服務(wù)方在Submit時(shí)寫(xiě)在ExtData參數(shù)中的值】
  	&State=【發(fā)送狀態(tài)，0：向網(wǎng)關(guān)提交成功，1：向網(wǎng)關(guān)提交失敗，2：發(fā)送成功，3：等待發(fā)送，4：發(fā)送失敗，5：Submit參數(shù)錯(cuò)誤】
  	（回車換行）

	回應(yīng)：Received CommandId=【對(duì)應(yīng)于發(fā)送時(shí)的命令標(biāo)識(shí)】（回車換行）
	
  4：分發(fā)中心為了測(cè)試服務(wù)方是否連接，會(huì)在等待1分鐘未收到任何數(shù)據(jù)發(fā)送測(cè)試指令，該指令也可由服務(wù)方主動(dòng)發(fā)起：
  
	分發(fā)中心或服務(wù)方==>ActiveTest CommandId=【命令標(biāo)識(shí)，4字節(jié)整型，循環(huán)使用】（回車換行）
	
	回應(yīng)：Received CommandId=【對(duì)應(yīng)于發(fā)送時(shí)的命令標(biāo)識(shí)】（回車換行）
	
  5：無(wú)論分發(fā)中心還是服務(wù)方，只要3分鐘之內(nèi)未收到任何數(shù)據(jù)要主動(dòng)斷開(kāi)連接，對(duì)于服務(wù)方在斷開(kāi)后重新連接。

加碼解碼規(guī)則：
	加碼時(shí)將字符串中的所有字符轉(zhuǎn)換成其對(duì)應(yīng)的ASCII值的16進(jìn)制值，例如：“A”的ASCII碼值為65，以16進(jìn)制值表示為41，故應(yīng)發(fā)送兩個(gè)字符
	“41”以代表字符“A”。對(duì)于漢字則以其內(nèi)碼的16進(jìn)制值來(lái)表示，如“測(cè)試”應(yīng)為：B2E2CAD4。參數(shù)中只要參數(shù)標(biāo)識(shí)與內(nèi)容之間用
	“:=”連接的都需要解碼后方可使用，解碼時(shí)將沒(méi)兩位當(dāng)成其ASCII值的16進(jìn)制值將其還原。
	
注：	
	1、命令和回應(yīng)并非一個(gè)命令完了后緊接者就回應(yīng)，服務(wù)方可一次發(fā)出許多條指令，可能在若干條后才陸續(xù)收到回應(yīng)，根據(jù)“Received”的
		“CommandId”可知道是對(duì)于哪一條發(fā)出指令的回應(yīng)。
	2、指令和參數(shù)標(biāo)識(shí)不區(qū)分大小寫(xiě)，但各參數(shù)內(nèi)容區(qū)分大小寫(xiě)。
	3、不需要的參數(shù)可不參與發(fā)送，此時(shí)系統(tǒng)認(rèn)為該參數(shù)值為系統(tǒng)默認(rèn)值。同時(shí)所有參數(shù)的位置并不固定，請(qǐng)不要按照位置獲取特定參數(shù)值。
	4、信息發(fā)送方對(duì)于參數(shù)如果進(jìn)行過(guò)加碼處理的其參數(shù)標(biāo)識(shí)和參數(shù)之間用“:=”連接，否則用“=”連接。同樣對(duì)于接收方，只要發(fā)現(xiàn)參數(shù)標(biāo)識(shí)和
	參數(shù)之間用“:=”連接，接收方必須對(duì)參數(shù)內(nèi)容進(jìn)行解碼方可使用。
	5、當(dāng)注冊(cè)類型為發(fā)送，回應(yīng)內(nèi)容也是從該通道反饋，但報(bào)告的反饋是從同注冊(cè)名的接收注冊(cè)通道反饋的。
	6、新網(wǎng)關(guān)測(cè)試需向鴻訊要求提供測(cè)試的注冊(cè)名和密碼。


  6: 錯(cuò)誤代碼：
     1、 100：用戶名或密碼不正確,登錄失敗
     2、 110：記費(fèi)號(hào)碼與注冊(cè)手機(jī)不符。
     3、 111: 實(shí)際IP與登錄IP不符

廈門商州數(shù)碼公司   博虎網(wǎng) www.pohoo.com

e-mail: service@pohoo.com

聯(lián)系人：闕明登		電話：0592-5157781