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

2019独角兽企业重金招聘Python工程师标准>>>

一．概述

此文档旨在指导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

转载于:https://my.oschina.net/wyqwclsn/blog/100692