人机验证接口文档

基本设置

（1）进入管理中心后台点击顶部导航的人机验证

（2）点击新建网站，填写网站简称及域名

域名支持使用来匹配子域名，填写示例：*.luosimao.com

（3）保存成功，获取site key 和 secret key

客户端设置

（1）在页面中加入如下代码，建议添加在 </body> 之前。

<script src="//captcha.luosimao.com/static/dist/api.js"></script>

为避免出现一些不必要的问题，请于下方HTML结构的后面添加此段代码，建议放在</body> 之前

（2）在需要出现图形验证的位置添加如下html结构

<div class="l-captcha" data-site-key="aab758dfe65d67a418589e950ea07b05"></div>

客户端设置的详细说明

（1）参数说明

以html attribute的形式添加在客户端设置（2）所示的结构上。

（2）传递服务端的方式

i. 同步传递

如果您的表单提交是采用同步的方法，即常见的form表单提交的形式
验证会在当前的表单内创建一个隐藏的表单域，name为 luotest_response，服务器端可以通过获取这个表单域的值来进行后续的验证。

ii. 异步传递

如果您的表单提交是采用异步的方法，即常见的ajax提交表单值的形式
您可以采用如下两个方法：

a. 通过获取表单中name为 luotest_response隐藏域的值 来进行提交（以下这段隐藏域请务必不要手动添加在页面内，验证成功后会由组件自动生成，建议根据此隐藏域的name属性来获取）

<input type="hidden" name="luotest_response" value="">

b. 通过设置data-callback，验证成功后的会以参数形式传递到您的设置的这个方法中，也可以获取到验证后的值。

data-callback="getResponse"

function getResponse(resp){
     console.log(resp);  // resp 即验证成功后获取的值
}

（3）可用方法

LUOCAPTCHA.reset()   重置验证

在JAVASCRIPT中调用此方法可以强制重置当前验证

点此查看人机验证DEMO

（4）invalid domain 错误

此错误的出现原因是 人机验证当前所属页面上的域名与后台填写的域名不一致。

请勿使用 localhost 或者 IP 形式进行测试，本地测试可以通过apache\iis\nginx 等创建主机。

服务器端设置

服务器端验证地址

https://captcha.luosimao.com/api/site_verify

请求方式:POST

{"error":0,"res":"success"}