1主賬號(hào)動(dòng)態(tài)短信碼驗(yàn)證接口
-
接口說(shuō)明
本接口主要提供給第三方應(yīng)用系統(tǒng)進(jìn)行4A主帳號(hào)+動(dòng)態(tài)短信碼的認(rèn)證概而，應(yīng)用系統(tǒng)根據(jù)4A主帳號(hào)登錄名和用戶輸入的短信碼按如下接口生成請(qǐng)求報(bào)文，調(diào)用4A短信秘鑰認(rèn)證服務(wù)進(jìn)行動(dòng)態(tài)短信碼認(rèn)證。
4A短信秘鑰認(rèn)證服務(wù)根據(jù)之前所生成的短信密鑰進(jìn)行認(rèn)證并將認(rèn)證結(jié)果返回給應(yīng)用側(cè)。
-
接口請(qǐng)求調(diào)用說(shuō)明
HTTP POST
UTF-8
-
入?yún)?/h4>
| 參數(shù)名 | 類型 | 必填 | 參數(shù)位置 | 描述 |
|---|---|---|---|---|
| apikey | string | 是 | header | API密鑰（加密）MD5的32位小寫(xiě)加密，主要用戶服務(wù)方對(duì)調(diào)用方進(jìn)行認(rèn)證竹勉。生成規(guī)則：MD5(apiSecret+MD5(systime+nonce)），MD5算法為32位16進(jìn)制小寫(xiě)娄琉，其中apiSecret是4A系統(tǒng)提供給接口調(diào)用的接口認(rèn)證秘鑰次乓，systime、nonce分別為請(qǐng)求頭中的systime车胡、nonce參數(shù) |
| reqid | string | 是 | header | 調(diào)用方應(yīng)用系統(tǒng)產(chǎn)生一個(gè)請(qǐng)求唯一標(biāo)識(shí) |
| appcode | string | 是 | header | 4A系統(tǒng)為接口調(diào)用方分配的系統(tǒng)代碼 |
| systime | string | 是 | header | 調(diào)用時(shí)產(chǎn)生的系統(tǒng)時(shí)間檬输，用于防止MD5碰撞照瘾，格式y(tǒng)yyyMMddHHmmss |
| nonce | string | 是 | header | 隨機(jī)數(shù)匈棘，防止用戶MD5碰撞 |
| serviceId | string | 是 | body | 應(yīng)用標(biāo)識(shí)，由4A統(tǒng)一分配 |
| mainAcct | string | 是 | body | 進(jìn)行認(rèn)證主帳號(hào)登錄名析命，3DES加密 |
| mobile | string | 是 | body | 手機(jī)號(hào), 3DES加密 |
| key | string | 是 | body | 進(jìn)行認(rèn)證的動(dòng)態(tài)短信碼主卫，3DES加密 |
-
入?yún)⑹纠?/h4>
header：
Content-Type:application/json
apikey:a0f8f693ff645f678a47df308adef506
reqid:1023864
appcode:SDP
systime:20200729202000
nonce:45481484
body：
{
"serviceId":"15874558",
"mainAcct":"FDSFASGE",
"mobile":"12345678999",
"key":"NFADK"
}
-
出參
| key | 類型 | 描述 |
|---|---|---|
| returnCode | string | 訪問(wèn)標(biāo)識(shí) 成功200 失敗500 |
| reqId | string | 與請(qǐng)求頭一致 |
| msg | string | 成功失敗消息提示 |
-
出參示例
正確：
http狀態(tài)碼返回200
響應(yīng)體：
{
"returnCode":"200",
"reqId":"1023864",
"msg":"認(rèn)證成功"
}
錯(cuò)誤：
http狀態(tài)碼返回500
響應(yīng)體：
{
"returnCode": "500",
"reqId":"1023864",
"msg": "系統(tǒng)發(fā)生異常錯(cuò)誤",
}
