空號檢測API
用戶通過HTTP的Get,POST方式提交檢測請求。
1.1 接口地址
接口地址 http://139.196.108.241:8081/Api/Detect.ashx
1.2 參數(shù)定義
序號 | 參數(shù) | 說明 |
1 | account | 必填參數(shù)。用戶賬號 |
2 | ts | 可選參數(shù),時間戳,格式y(tǒng)yyyMMddHHmmss |
3 | pswd | 必填參數(shù)。用戶密碼,ts參數(shù)為空時填明文密碼,ts參數(shù)不為空時填md5(賬號+密碼+時間戳),對賬號密碼時間戳拼接的字符串進(jìn)行md5加密 |
4 | mobile | 必填參數(shù)。合法的手機號碼,號碼間用英文逗號分隔。最大50個號碼 |
1.3 提交響應(yīng)
用戶通過http請求提交到服務(wù)器后,服務(wù)器返回響應(yīng)
1.3.1 返回JSON格式示例
{
"code": 0,
"msg": "ok",
"result": [{
"mobile": "xxxxxxxxxxx",
"state": 1
}, {
"mobile": "xxxxxxxxxxx",
"state": 0
}]
}
code 為響應(yīng)狀態(tài)(0表示成功,其他表示失敗),msg 為提示消息)
業(yè)務(wù)結(jié)果result說明
屬性 | 說明 |
mobile | 手機號 |
state | 檢測結(jié)果 -1 風(fēng)險 0 空號 1 實號 |
code響應(yīng)狀態(tài)值說明
代碼 | 說明 |
-1 | 一般錯誤 |
0 | 成功 |
101 | 無此用戶 |
102 | 密碼錯 |
108 | 手機號碼個數(shù)錯(>50或<=0) |
109 | 無發(fā)送額度(該用戶可用條數(shù)為0) |
1.4 注意事項
1. 單次提交的手機號碼數(shù)量限制在50以內(nèi)
1.5 提交例子
http://139.196.108.241:8081/Api/Detect.ashx?account=xx&pswd=xx&mobile=x