[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将被自动拉黑。一般情况下不会触发的!