[TOC] # 识别接口 | 识别接口 | 注意:http请求 连接超时设为60秒 切勿过短避免没有收到结果就断开连接 | | --- | --- | --- | 请求地址 | http://jiyanapi.c2567.com/shibie | | 参数说明 | 填写 | 示例值 | 参数描述 | | - | - | - | - | | user | **必填** | test | 用户名 [点击这里注册账户 联系客服免费提供点数测试](http://jiyan.c2567.com/index.php/login/index.html) | pass | **必填**| test | 用户名的密码 | gt | **必填** | String | 验证码的参数gt,传入时请检查变量是否空,过多错误将会拉黑IP | challenge | 可空 | String | 该参数只能用1次,如失败识别,请重新获取该参数 [challenge抓取教程](%E6%8A%93%E5%8F%96%E5%8F%8A%E5%88%86%E6%9E%90.md) | referer | **必填** | http://www.baidu.com | 来源地址。只需要提供你所识别网站的域名 | return | **必填**| json | 返回数据按照json格式.&return=json | model | **必填** | 0 | [点击查看说明 model参数详细说明](#model_81) | hosts | 可空 | xxxx.geetest.com | 一般无需设置,参数指定的域名 | ip | 可空 | 无 |不需要填,若需要提交代理ip识别,请联系客服咨询。 | format | 可空 | utf8 | 默认为gbk,如需utf-8编码请填写。&format=utf8 | supportclick | 可空 | jiyan |不需要填默认支持汉字点选 [点击查看说明 如需要支援点击汉字验证码](#_145) | supportuser | 可空| 无 |打码平台的账号 | supportpass |可空| 无 |打码平台的账号的密码 例如 ``` http://jiyanapi.c2567.com/shibie?gt=请输入gt参数&challenge=请输入challenge参数&referer=请输入来源地址参数&user=test&pass=test&return=json&model=3&format=utf8 ``` ## 接口返回结果 默认编码为GBK |json结果 | 推荐使用json数据返回 | | - | - | | status | ok,识别成功。no,识别失败请重试,stop,用户账号有问题,请停止软件,并提示错误信息 | | msg | 返回错误信息 默认为gbk,如需utf-8编码请填写。&format=utf8 | ### status=ok,请带着识别成功的数据提交 识别成功返回的,**请务必**使用我们接口返回的`challenge`和`validate` ``` { status: "ok", challenge: "3d033f099597f5ae63e2e2c902301d183z", validate: "8f6ebd56291ed6569ac40c1d74780985" } ``` 现在你可以在抓包结果中找到这3个参数,替换提交即可. ``` &geetest_challenge=challenge &geetest_validate=validate &geetest_seccode=validate|jordan geetest_seccode结果和validate是一样的请注意. ``` ### status=no 请重新获取验证码参数,并重新提交识别。 ``` { status: "no", msg: "行为异常" } ``` [错误代码及处理方法](错误代码及处理方法.md) ### status=stop 请停止程序并提示错误信息。该状态是账号有问题的情况。 #### **提示stop后,请务必停止软件,谢谢您** ``` { status: "stop", msg: "用户名不存在或密码错误" } ``` ## model参数详细说明 ### 第二代 只要是第二代所有的样例均支持,无论图样是如何的。 | 验证码类型 | 样例 | 参数设置 | 费用 | | --- | --- | --- | --- | | 滑动拼图 | ![](http://jiyan.c2567.com/Public/d.jpg) | model=0或者model=1 | 1点 #### **请务必判断success的值,设置正确的识别模式** ``` {"success":0,"gt":"gt","challenge":"challenge"} ``` success=0 传入 &model=1, success=1 无需传入该参数,留空即可,一般情况下无需设置该参数。 ### 第三代 | 验证码类型 | 样例 | 参数设置 | 费用 | | --- | --- | --- | --- | | 第三代 点按式 | ![](http://jiyan.c2567.com/Public/new-captcha.gif) | &model=3 | 1点 | 第三代 点按后滑动式 | ![](https://box.kancloud.cn/12e756c7d1c81e878aa93b5e297e17c9_376x300.png) | &model=3 | 1点 | 第三代 点按后选字 | ![](https://box.kancloud.cn/67509441c5d4c72be18f40cc53454c04_262x336.jpg) | &model=3 | 2分钱价值的点数 | 第三代 点按后选图 | ![](https://box.kancloud.cn/b22ba532607a3811c058c1cfdb6f179a_260x332.png)| &model=3 | 2分钱价值的点数 | 第三代 选择语序 |![](https://box.kancloud.cn/dc0bb51587f48846c885ccfb1a4b26b2_290x371.png)| &model=3 | 2分钱价值的点数 | 第三代 点按后选图案 | ![](https://box.kancloud.cn/6f6d96feddb14cfed0adef9861d92bd9_344x440.png)| &model=3 | 2分钱价值的点数 | 第三代 点按后选图形 | ![](https://box.kancloud.cn/10beba14069e7b51ec912ca37d13438d_322x412.png)| &model=3 | 2分钱价值的点数 需要使用若快 例如返回的验证码参数为 ``` { success: 0, gt: "0f6dcb26b411a6c0fd7d4a0ef5891dd3", challenge: "7cbbc409ec990f19c78c75bd1e06f21532", new_captcha: 1 } ``` #### 请务必判断success的值,设置正确的识别模式 **这里需要判断`success`的值** ``` success = 1 使用 &model=3 一般情况下第三代验证码设置这个 success = 0 使用 &model=4 参数success参数为0的时候设置 ``` ### 汉字点选 **默认已使用本平台内置汉字点选** **汉字点选一律收费2分钱 价格更便宜 速度更快 效果比若快好** 设置该参数后遇到汉字点选将收取价值2分钱的点数。 例如您的充值优惠是5厘那么扣除4个点数。优惠是1分钱那么扣费2个点数。 若遇到点选直接通过或点击后出现滑动通过,只扣费1个点数。 ``` &supportclick=jiyan ``` #### 如果您需要使用若快支援点选汉字(一般情况下不需要使用若快) 设置该参数后,遇到汉字将使用第三方提供的点按服务,这是需要额外付费的。 默认情况下我们平台内置点选已经支持了。一般情况下不需要使用若快 ![](https://box.kancloud.cn/67509441c5d4c72be18f40cc53454c04_262x336.jpg) 如果需要若快支持汉字点选,请注册若快打码 [点击这里注册若快账号](http://www.ruokuai.com/home/register) 然后在识别接口中加入参数 ``` &supportclick=ruokuai&supportuser=请输入您的若快账号&supportpass=请输入您的若快账号的密码 ``` **设置支持若快需要额外付费** 请将http连接超时时间设置 90秒 避免没有识别到验证码就断开。 请勿使用大量线程 若快客服说 承受不住 请保持在100线程内。 消耗45快豆等于人民币1.8分,如通过识别我们平台也收取1点数。 **请在若快中绑定软件代码 ``** 以便正常使用. > 使用若快 费用提醒 > 如按照我们平台最低价点数价值5厘 > 若快点选 收取1.8分,我们平台收取5厘 总和 2.3分) > 如果使用本平台点选仅收取2分 设置为 `&supportclick=jiyan` 即可,无需使用若快,并且价格更加优惠。 ## **特别注意 拉黑IP规则!!!** ## 传入识别时,必须判断 gt 和 challenge的值 是否为空,如果为空,请不要传入识别,避免过多的无效请求,超过阀值,IP将被自动拉黑。一般情况下不会触发的!