愛碼手機驗證碼接收平臺Http接口說明

1、Http接口流程圖用戶接入流程：用戶獲取號碼注：調(diào)用獲取號碼(httpUserGetMobileAction)接口時需要傳入項目編號，可以調(diào)獲取項目列表(httpGetProjectInfosAction)接口獲得用戶需要的項目編號。接口地址：http:/ httpUserGetMobileAction.do調(diào)用方式：GET、POST調(diào)用實例：獲取兩個項目調(diào)用示例：成功返回：111 回車換行獲取號碼1 回車換行獲取號碼2 回車換行獲取號碼3 回車換行獲取號碼N 非成功直接返回錯誤碼接口參數(shù)參數(shù)名稱描述userID用戶ID必選參數(shù)password密碼必選參數(shù)，密碼為md5小寫加密size獲取數(shù)量

2、必選參數(shù)projectID項目編號必選參數(shù)狀態(tài)碼參數(shù)說明111獲取號碼成功408必選參數(shù)為空！509無法獲取該項目。600獲取號碼提示：操作過于頻繁！601獲取號碼提示：無可用號碼！602獲取號碼提示：項目不存在！603獲取號碼提示：獲取數(shù)大于系統(tǒng)限制,獲取失敗!604獲取號碼提示：用戶愛碼幣不足，無法獲取號碼! 請進行充值。501用戶名確認失敗。611獲取號碼提示：獲取后，獲取號碼數(shù)量大于限制獲取數(shù)量，獲取失敗。612獲取號碼提示：操作過于頻繁! 已獲取過多個項目，僅獲取一次430同一個ip，在指定時間內(nèi)只能調(diào)用一次。調(diào)用頻繁獲取項目接口地址：http:/ / httpGetProjectI

3、nfosAction.do調(diào)用方式：GET、POST調(diào)用實例： /httpGetProjectInfosAction.do?userID=userID&password=password成功返回：111 回車換行 項目ID 1;項目名稱1;項目網(wǎng)址1;項目單價1回車換行項目ID 2;項目名稱2;項目網(wǎng)址2;項目單價2回車換行 項目ID 3;項目名稱3;項目網(wǎng)址3;項目單價3回車換行項目ID N;項目名稱N;項目網(wǎng)址N;項目單價N 非成功直接返回錯誤碼注：項目名稱是經(jīng)過編碼轉(zhuǎn)換的(URLEncoder.encode(fmt,UTF-8)，獲取項目后請使用URLDecoder.decode(fmt

4、,UTF-8)解碼。接口參數(shù)參數(shù)名稱描述userID用戶ID必選參數(shù)password密碼必選參數(shù)，密碼為md5小寫加密狀態(tài)碼參數(shù)說明111獲取項目成功!408必選參數(shù)為空！501用戶名確認失敗。000操作異常接收驗證碼接口地址：n/ httpGetCodeAction.do調(diào)用方式：GET、POST調(diào)用實例：成功返回：111 回車換行手機號碼1;對應(yīng)驗證碼1回車換行手機號碼2;對應(yīng)驗證碼2回車換行手機號碼3;對應(yīng)驗證碼3回車換行手機號碼N;對應(yīng)驗證碼N 非成功直接返回錯誤碼接口參數(shù)參數(shù)名稱描述userID用戶ID必選參數(shù)password密碼必選參數(shù)，密碼為md5小寫加密projectID項目I

5、D必選參數(shù)mobile手機號碼必選參數(shù)，多個號碼以逗號隔開，最多不能超過235個softWareID軟件廠商可以為空，如果非軟件指定傳入為空值即可。狀態(tài)碼參數(shù)說明111獲取驗證碼成功408必選參數(shù)為空！600獲取驗證碼失敗，您的操作過于頻繁601獲取驗證碼失敗，無可用號碼供獲取!602獲取驗證碼失敗，獲取項目不存在!603獲取驗證碼失敗，獲取號碼數(shù)大于系統(tǒng)限制!604獲取驗證碼失敗，您的愛碼幣不足!605獲取驗證碼失敗，無驗證碼!501用戶名確認失敗。000操作異常507號碼長度過多430同一個ip，在指定時間內(nèi)只能調(diào)用一次。調(diào)用頻繁查詢已獲取驗證碼號碼接口地址： / httpGetCheck

6、MobileAction.do調(diào)用方式：GET、POST調(diào)用實例：接口說明：查詢用戶已獲取驗證碼項目的號碼。成功返回：111 回車換行獲取號碼1 ;項目編號1;獲取時間1;項目名稱1;項目單價1 回車換行獲取號碼2 ;項目編號1;獲取時間1;項目名稱1;項目單價1 回車換行獲取號碼3 ;項目編號1;獲取時間1;項目名稱1;項目單價1 回車換行獲取號碼N ;項目編號N;獲取時間N;項目名稱N;項目單價N非成功直接返回錯誤碼注：項目名稱是經(jīng)過編碼轉(zhuǎn)換的(URLEncoder.encode(fmt,UTF-8)，獲取號碼后請使用URLDecoder.decode(fmt,UTF-8)解碼。接口參數(shù)參

7、數(shù)名稱描述userID用戶ID必選參數(shù)password密碼必選參數(shù)，密碼為md5小寫加密狀態(tài)碼參數(shù)說明111獲取驗證碼號碼成功408必選參數(shù)為空！601用戶沒有獲取驗證碼號碼501用戶名確認失敗。000操作異常查詢已獲取發(fā)送指令號碼接口地址： / httpGetOrderMobileAction.do調(diào)用方式：GET、POST調(diào)用實例： httpGetOrderMobileAction.do?userID=userID&password=password接口說明：查詢用戶已獲取發(fā)送指令項目的號碼。成功返回：111 回車換行獲取號碼1 ;項目編號1;獲取時間1;項目名稱1;項目單價1 回車換行獲

8、取號碼2 ;項目編號1;獲取時間1;項目名稱1;項目單價1 回車換行獲取號碼3 ;項目編號1;獲取時間1;項目名稱1;項目單價1 回車換行獲取號碼N ;項目編號N;獲取時間N;項目名稱N;項目單價N非成功直接返回錯誤碼注：項目名稱是經(jīng)過編碼轉(zhuǎn)換的(URLEncoder.encode(fmt,UTF-8)，獲取號碼后請使用URLDecoder.decode(fmt,UTF-8)解碼。接口參數(shù)參數(shù)名稱描述userID用戶ID必選參數(shù)password密碼必選參數(shù)，密碼為md5小寫加密狀態(tài)碼參數(shù)說明111獲取發(fā)送短信號碼成功408必選參數(shù)為空！601用戶沒有獲取發(fā)送短信號碼501用戶名確認失敗。000

9、操作異常用戶查詢愛碼幣接口地址：http:/ httpGetUserScoreAction.do調(diào)用方式：GET、POST調(diào)用實例： / httpGetUserScoreAction.do?userID=userID&password=password成功返回：111 回車換行 用戶ID用戶愛碼幣：對應(yīng)愛碼幣非成功直接返回錯誤碼接口參數(shù)參數(shù)名稱描述userID用戶ID必選參數(shù)password密碼必選參數(shù)，密碼為md5小寫加密狀態(tài)碼參數(shù)說明111獲取用戶愛碼幣成功408必選參數(shù)為空！501用戶名確認失敗。000操作異常用戶解鎖獲取號碼接口地址：http:/ httpClearLockByUser

10、Action.do調(diào)用方式：GET、POST調(diào)用實例：接口說明：mobile號碼為可選參數(shù)，如果為空值時：解鎖對應(yīng)的項目id的所有獲取的號碼；如果mobile不為空值時：則解鎖對應(yīng)項目上對應(yīng)的號碼，傳入多個號碼存在的將會解鎖。成功返回：111 非成功直接返回錯誤碼接口參數(shù)參數(shù)名稱描述userID用戶ID必選參數(shù)password密碼必選參數(shù)，密碼為md5小寫加密projectID項目ID必選參數(shù)mobile手機號碼可選參數(shù)，多個號碼以逗號隔開，最多不能超過235個狀態(tài)碼參數(shù)說明111解鎖號碼成功408必選參數(shù)為空！501用戶名確認失敗。000操作異常222沒有相應(yīng)的解鎖號碼用戶獲取號碼加黑接口地

11、址：http:/ httpAddBlackMobileAction.do調(diào)用方式：GET、POST調(diào)用實例：接口說明：加黑用戶已獲取的號碼。成功返回：111 非成功直接返回錯誤碼接口參數(shù)參數(shù)名稱描述userID用戶ID必選參數(shù)password密碼必選參數(shù)，密碼為md5小寫加密projectID項目ID必選參數(shù)mobile手機號碼必選參數(shù)，多個號碼以逗號隔開，最多不能超過235個狀態(tài)碼參數(shù)說明111加黑號碼成功408必選參數(shù)為空！501用戶名確認失敗。000操作異常222沒有相應(yīng)的加黑號碼用戶釋放加黑號碼接口地址：http:/ httpClearBlackMobileAction.do調(diào)用方式：

12、GET、POST調(diào)用實例：接口說明：mobile為可選參數(shù)，當傳入為空值時：將釋放對應(yīng)項目上所有的加黑號碼；如果mobile不為空值時：將釋放存在項目上對應(yīng)的號碼。成功返回：111 非成功直接返回錯誤碼接口參數(shù)參數(shù)名稱描述userID用戶ID必選參數(shù)password密碼必選參數(shù)，密碼為md5小寫加密projectID項目ID必選參數(shù)mobile手機號碼可選參數(shù)，多個號碼以逗號隔開，最多不能超過235個狀態(tài)碼參數(shù)說明111釋放加黑號碼成功408必選參數(shù)為空！501用戶名確認失敗。000操作異常222沒有相應(yīng)的釋放加黑號碼用戶發(fā)送指令短信接口地址：http:/ httpUserSendNoteAction.do調(diào)用方式：GET、POST調(diào)用實例：接口說明：用戶根據(jù)獲取發(fā)送指令的項目，發(fā)送短信。成功返回：111 非成功直接返回錯誤碼接口參數(shù)參數(shù)名稱