介紹
包括驗(yàn)證碼ctoken獲取,驗(yàn)證碼ctoken-結(jié)果對保存沿癞,以及驗(yàn)證碼結(jié)果校驗(yàn)三個功能矛渴,分別對應(yīng)了SOA接口(com.lcb.soa.captcha.service.ICaptchaService)和 HTTP API+JSON 接口(com.lcb.soa.captcha.controller.ICaptchaAdminController)。SOA接口調(diào)用直接代碼引用蚕涤。下面是HTTP API接口的具體調(diào)用地址和對應(yīng)契約(in JSON)铣猩。
驗(yàn)證碼令牌獲取接口:ICaptchaAdminController.getToken
- HTTP API 暴露地址:http://serverhost:10006/text_captcha_admin/getToken
- 請求契約:
{
"appCode":"100"
} - 返回契約:
{
"costTime": 34,
"msg": "ok",
"result": {
"error": null,
"success": true,
"token": "ZNHhGpumtiskiItmSGqe"
},
"statusCode": "200",
"validationErrors": null
}
說明:獲取驗(yàn)證碼令牌的時候,無需傳參數(shù)(必要字段除外)天吓。
驗(yàn)證碼令牌和結(jié)果保存接口:ICaptchaAdminController.save
- HTTP API 暴露地址:http://serverhost:10006/text_captcha_admin/save
- 請求契約:
{
"appCode":"1901",
"captchaToken":"asdfkasdssss",
"captchaResult":"Gx3u"
} - 響應(yīng)契約:
{
"costTime":299,
"msg":"ok",
"result":
{
"error":null,
"success":true
},
"statusCode":"200",
"validationErrors":null
}
驗(yàn)證碼結(jié)果校驗(yàn)
- HTTP API 暴露地址:http://serverhost:10006/text_captcha_admin/validate
- 請求契約:
{
"appCode":100,
"captchaResult":"K7RM",
"captchaToken":"asdfkasdssss"
} - 響應(yīng)契約:
{
"costTime": 54,
"msg": "ok",
"result": {
"error": null,
"pass": false,
"success": true
},
"statusCode": "200",
"validationErrors": null
}