愛碼手機(jī)驗(yàn)證碼接收平臺(tái)Http接口說明

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

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

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

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

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

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

7、使用URLDecoder.decode(fmt,"UTF-8")解碼。接口參數(shù)參數(shù)名稱描述userID用戶ID必選參數(shù)password密碼必選參數(shù)，密碼為md5小寫加密狀態(tài)碼參數(shù)說明111獲取驗(yàn)證碼號(hào)碼成功408必選參數(shù)為空！601用戶沒有獲取驗(yàn)證碼號(hào)碼501用戶名確認(rèn)失敗。000操作異常查詢已獲取發(fā)送指令號(hào)碼接口地址： / httpGetOrderMobileAction.do調(diào)用方式：GET、POST調(diào)用實(shí)例： httpGetOrderMobileAction.do?userID=userID&password=password接口說明：查詢用戶已獲取發(fā)送指令項(xiàng)

8、目的號(hào)碼。成功返回：111 回車換行獲取號(hào)碼1 ;項(xiàng)目編號(hào)1;獲取時(shí)間1;項(xiàng)目名稱1;項(xiàng)目單價(jià)1 回車換行獲取號(hào)碼2 ;項(xiàng)目編號(hào)1;獲取時(shí)間1;項(xiàng)目名稱1;項(xiàng)目單價(jià)1 回車換行獲取號(hào)碼3 ;項(xiàng)目編號(hào)1;獲取時(shí)間1;項(xiàng)目名稱1;項(xiàng)目單價(jià)1 回車換行獲取號(hào)碼N ;項(xiàng)目編號(hào)N;獲取時(shí)間N;項(xiàng)目名稱N;項(xiàng)目單價(jià)N非成功直接返回錯(cuò)誤碼注：項(xiàng)目名稱是經(jīng)過編碼轉(zhuǎn)換的(URLEncoder.encode(fmt,"UTF-8")，獲取號(hào)碼后請使用URLDecoder.decode(fmt,"UTF-8")解碼。接口參數(shù)參數(shù)名稱描述userID用戶ID必選參數(shù)passwo

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

10、數(shù)說明111獲取用戶愛碼幣成功408必選參數(shù)為空！501用戶名確認(rèn)失敗。000操作異常用戶解鎖獲取號(hào)碼接口地址：http:/ httpClearLockByUserAction.do調(diào)用方式：GET、POST調(diào)用實(shí)例：接口說明：mobile號(hào)碼為可選參數(shù)，如果為空值時(shí)：解鎖對應(yīng)的項(xiàng)目id的所有獲取的號(hào)碼；如果mobile不為空值時(shí)：則解鎖對應(yīng)項(xiàng)目上對應(yīng)的號(hào)碼，傳入多個(gè)號(hào)碼存在的將會(huì)解鎖。成功返回：111 非成功直接返回錯(cuò)誤碼接口參數(shù)參數(shù)名稱描述userID用戶ID必選參數(shù)password密碼必選參數(shù)，密碼為md5小寫加密projectID項(xiàng)目ID必選參數(shù)mobile手機(jī)號(hào)碼可選參數(shù)，多個(gè)號(hào)碼以

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

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