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