YinXiangMa_SDK_For_Java_V2.0接口开发者使用说明

一．概述

此文档旨在指导Java网站主如何在本身的网站中植入印象码。

做为Java网站的开发者，仅须要在网站后台进行简单的配置，就能够轻松地在您所搭建的网站上使用印象码，在使用安全、用户体验良好的验证码的同时，也为网站主带来可观的收入。

二．SDK植入流程

1.    获取网站Key

1）  请访问http://www.yinxiangma.com注册网站主账户并等待审核。

2） 登录印象码广告平台，点击导航栏站点管理->新建站点，而后，根据提示完成站点的建立，包含三部分：选择验证码类型、站点基本信息设置、验证码外观设置。

3） 建立站点后，点击站点key便可看到以下图所示的页面，而且看到本身站点的key：

2.    显示验证码

在页面中须要放置验证码的位置添加以下代码：

<input type='hidden' id='YXM_here' />

<script type='text/javascript' charset='gbk' id='YXM_script' async src='http://api.yinxiangma.com/api2/yzm.yinxiangma.php?pk=f619ca7d2ae0ff99e5727f697a6a2882&v=YinXiangMaJavaSDK_2.0'></script>

*注意将上面红色部分修改成本身的PUBLICK_KEY

3.    校验结果

1）将com.YinXiangMa.jar放在网站的编译路径lib下；

2）导入印象码jar包：

import com.YinXiangMa.*;

3）验证码校验：

String yxm_result;

yxm_result=YinXiangMa.Check_Answer("870bb0b9ddc3004edde88ecf3dd9fca1",request.getParameter("YinXiangMa_challenge"),request.getParameter("YXM_level"),request.getParameter("YXM_input_result"));

if (yxm_result=="true"){ //校验正确后的操做 }

else{ //校验失败后的操做 }

*注意将上面红色部分修改成本身的PRIVATE_KEY

三．样例程序使用说明

1.     Java的SDK压缩包中，Demo_SDK_JSP_V2.0.rar为用myeclipse开发的简单的样例程序，而且有ajax校验的示例。请开发者参照。

SDK下载地址：http://www.yinxiangma.com/sdk/Java_2.0.rar