YinXiangMa_SDK_For_PHP_V3.0接口開發者使用說明

一．概述

此文檔旨在指導PHP網站主如何在本身的網站中植入印象碼。

做爲PHP網站的開發者，僅須要進行簡單的配置，就能夠輕鬆地在您所搭建的網站上使用印象碼，在使用安全、用戶體驗良好的驗證碼的同時，也爲網站主帶來可觀的收入。

二．SDK植入流程

1.    獲取網站Key

1）  請訪問http://www.yinxiangma.com註冊網站主賬戶並等待審覈。

2） 登錄印象碼廣告平臺，點擊導航欄站點管理->新建站點，而後，根據提示完成站點的建立，包含：站點基本信息設置、驗證碼外觀設置。

3） 建立站點後，點擊站點key便可看到以下圖所示的頁面，而且看到本身站點的key：

2.    顯示驗證碼

1）打開YinXiangMaLibConfig.php文件，在其中找到以下代碼作相應的配置，將第二步獲得的兩個PRIVATE_KEY在這裏設置：

define("PRIVATE_KEY","6b07b633b4498fc1949e927873857f2a");

*注意將上面紅色部分修改成本身的PRIVATE_KEY

2）在頁面中須要放置驗證碼的位置添加以下代碼：

<script type='text/javascript' charset='gbk'>

var YXM_PUBLIC_KEY = '363eb5f8fd2c87abc84f68876b9d320e';//*左側紅色部分修改成本身的PUBLICK_KEY

var YXM_localsec_url = 'http://127.0.0.1/YinXiangMa_PHP_SDK_Demo/localsec/';//*左側紅色部分修改成應急策略路徑

function YXM_local_check()

{

if(typeof(YinXiangMaDataString)!='undefined')return;

YXM_oldtag = document.getElementById('YXM_script');

var YXM_local=document.createElement('script');

YXM_local.setAttribute("type","text/javascript");

YXM_local.setAttribute("id","YXM_script");

YXM_local.setAttribute("src",YXM_localsec_url+'yinxiangma.js?pk='+YXM_PUBLIC_KEY+'&v=YinXiangMaPHPSDK_3.0');

YXM_oldtag.parentNode.replaceChild(YXM_local,YXM_oldtag); 

}

setTimeout("YXM_local_check()",2000);

document.write("<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="+YXM_PUBLIC_KEY+"&v=YinXiangMaPHPSDK_3.0'><"+"/script>");

</script>

3.    校驗結果

1）在您的PHP校驗頁面代碼中，首先添加印象碼類庫，而後調用咱們封裝的函數進行校驗，代碼以下：

<?php

require_once("YinXiangMaLib.php");

$YinXiangMa_response=YinXiangMa_ValidResult(@$_POST['YinXiangMa_challenge'],@$_POST['YXM_level'][0],@$_POST['YXM_input_result']);

if($YinXiangMa_response == "true") { echo "Yes!";}

else { echo "No!";}

?>

2）添加Ajax異步校驗效果

<script type='text/javascript'>

function YXM_valided_true(){

//驗證碼輸入正確後的操做

}

function YXM_valided_false(){

//驗證碼輸入錯誤後的操做

}

</script>

三．樣例程序使用說明

1.     將PHP的SDK壓縮包中的YinXiangMa_PHP_SDK_Demo文件夾放在網站根目錄下

2.     訪問demo的Login.html，好比http://127.0.0.1/YinXiangMa_PHP_SDK_Demo/Login.html便可看到印象碼的demo展現效果，輸入驗證碼後，點擊校驗，就可看到校驗的結果。

SDK下載地址：http://www.yinxiangma.com/sdk/PHP_3.0.rar