* 接口地址： http://api.rrocr.com/api/recognize.html
* 请求类型：POST
### 请求参数
| 参数 | 属性 | 描述 |
|:----- |:-----|----- |
| appkey| 必填 | 用户中心提供的appkey |
| gt | 必填 |验证码所在网站极验的gt值，如果是四代的话gt参数为captcha_id值|
| challenge| 选填 | 通过请求目标站配置项获取，每次获取到的challenge仅能使用一次。如网站为极验感知无此参数可不填，如果是四代的话challenge无需传|
| referer| 必填 | 验证码所在的页面URL|
| mmt_key| 选填 | 特定网站所需的参数，四代个别定制板如有此参数需要传此参数，如定制版包里有mmt_key需要传此参数|
| risk_type| 选填 | 特定网站所需的参数，四代个别定制板如有此参数需要传此参数，抓到的包中,load请求参数中有则需要填,无则不需要填|
| proxy_ip | 选填 | 注意此参数原ip字段废弃更名为proxy_ip，代理ip参数，如果有些网站认ip的话，可传此参数注意代理ip格式为：【ip:port】，如果代理ip是ip白名单的，需要把此ip【27.151.28.63】添加到白名单，如果未添加白名单或者账号密码有问题统一返回105|
| ip_account | 选填 | 代理ip鉴权的账号，如果代理ip为白名单无需传此参数 |
| ip_password | 选填 | 代理ip鉴权的密码，如果代理ip为白名单无需传此参数 |
| host | 选填 |特殊网站极验抓包为三级域名的比如api-na.geetest.com这样的需要传对应的域名需要传此参数，注意不要带【http://】和【/】只需要域名即可|
| useragent | 选填 |自定义UA，适用于某些检验UA的网站，此参数需要URL编码|
| sharecode | 选填 | 开发者密钥 |
### 返回结果
注意:http请求 连接超时设为60秒 切勿过短避免没有收到结果就断开连接
```
POST /api/recognize.html HTTP/1.1
Host: api.rrocr.com
User-Agent: Mozilla/5.0 Chrome/77.0.3865.120 Safari/537.36
Accept: text/html;
Content-Type:application/x-www-form-urlencoded;
appkey=21da8e03d090acc54dc5c6677a9ef8ef>=c9c4facd1a6feeb80802222cbb74ca8e&challenge=97f46c4c54f19a1ef4b1558018dde310&referer=http://www.baidu.com&ip=&host=
成功返回
三代
{
"status": 0,
"msg": "识别成功",
"data": {
"challenge": "97f46c4c54f19a1ef4b1558018dde310",
"validate": "71a2b5eaf8352695d4db042b36e91e46"
}
"time":3467
}
四代【注意事项：如遇无法通过可能是网站编码问题，则captcha_output的 '='符号用%3D替换，其他无需编码，请注意该事项】
{
"status": 0,
"msg": "识别成功",
"data": {
"challenge": "12729b40-f360-4d02-9ddb-00c17711baf6",
"seccode": {
"captcha_id": "68309e2ff42954131328bc455ce80c14",
"lot_number": "a9931f30755542f48b17ace3deb1ff60",
"pass_token": "7887b8f3dc11da1d137eaec7f9a222452e37e80217fd9295a5cbdfb0fa8b0fb7",
"gen_time": "1656172614",
"captcha_output": "1P9rHCof8yt7R_zB5hE5Z81aXgM4KzOJF7hIH3-jfCxeVyi26gVsyxVlD9LICxvSyC6faJnTdmMJFnqr8y5VhsLg_540Inc8ARjzonfC18F1-IIAQfGPd8X7Dxur0lFxjmP93i9mogmm66l6HZsCWdxQjS421KWOt6_JjB7S8m522KRG3tG_-yThSROb8xrRHVa-5YpmYyX3ZCKUn-TRI9SxTT9WjGhNM9gkJhm-epI1MWnvUNqLVAzqWEUOQaB="
}
}
"time":3467
}
失败返回
{
"status": -1,//用户积分不足也是这个值msg不同信息
"msg": "识别失败",
"code": 1004
}
```
# code错误代码
| code | 描述 |
| --- | --- |
| 1001 | IP代理网络错误 |
| 1011 | 网络异常，IP被封 |
| 1002 | 获取challenge错误 请检查提交的challenge是不是极验网站的 |
| 1022 | 内部错误 |
| 1003 | 坐标识别错误 |
| 1033 | 轨迹错误 |
| 1004 | 识别初始化错误 请检查是不是初始页面得来的challenge 长度为32位且只提交过平台一次且不是从抓包得来的 |
| 1044 | 识别初始化错误1 请检查是不是初始页面得来的challenge 长度为32位且只提交过平台一次且不是从抓包得来的 |
| 1005 | 获取必须参数失败 |
| 1055 | 屏蔽bug网站 |
| 108 | challenge参数有错误不是极验的或者请检查提交是否为三代类型并且检查参数challenge是否为空 |
~~~
~~~
# 其他注意事项
1、请不要从浏览器开发者工具中直接复制,需要请求后获取gt和challenge
2、少量错误重新获取验证码参数重试即可
3、验证码参数只能提交识别一次，切勿同样的参数重复提交识别，需要重新初始化获取
