* 接口地址: http://api.z-fp.com/start_handle
* 请求类型:POST
### 请求参数
| 参数 | 属性 | 描述 |
|:----- |:-----|----- |
| username| required | 注册的用户名|
| appkey| required | 用户中心提供的appkey |
| gt | required |验证码所在网站极验的gt值
| challenge| required | 通过请求目标站配置项获取,每次获取到的challenge仅能使用一次。如网站为极验感知此参数可不填,比如拉钩
| referer| required | 验证码所在的页面URL
| handle_method | required | 识别模式默认是 three_on |
| dev_username | optional |软件开发者用户名,用于参与分成,可不传|
| handle_method 参数说明 | 描述 |
|:----- |:-----|----- |
| three_on | 第三代正常识别模式|
| three_off | 第三代离线识别模式|
| two_on | 第二代滑块正常识别模式|
| two_off | 第二代滑块离线识别模式 |
| deepknow| 深知Pro类型识别需要提交gt参数 |
### 返回结果
注意:http请求 连接超时设为60秒 切勿过短避免没有收到结果就断开连接
```
// http://api.z-fp.com/start_handle?username=qq&appkey=21da8e03d090acc54dc5c6677a9ef8ef>=c9c4facd1a6feeb80802222cbb74ca8e&challenge=97f46c4c54f19a1ef4b1558018dde310&handle_method=three_on
{
"code": 200,
"msg": "ok",
"data": {
"challenge": "97f46c4c54f19a1ef4b1558018dde310",
"validate": "71a2b5eaf8352695d4db042b36e91e46"
}
}
```
# code=502
请停止您的软件或者脚本 账户积分不足
账户没有积分了
提交的参数错误的情况
```
// http://api.z-fp.com/start_handle?username=qq&appkey=>=c9c4facd1a6feeb80802222cbb74ca8e&challenge=97f46c4c54f19a1ef4b1558018dde310&handle_method=three_on
{
"code": 501,
"msg": "请输入用户名和appkey",
"data": null
}
```
# 错误代码
| code | 描述 |
| --- | --- |
| 501 | 参数错误 检查 gt 和 challenge 是否正确 |
| 502 | 账户积分不足 请停止软件或脚本 没有积分请不要一直提交识别请求 |
| msg| 描述 |
| --- | --- |
| retry 1033 | 验证码加载失败 1,检查gt和challenge参数 2.请不要从浏览器开发者工具中直接复制,需要请求后获取gt和challenge 3.检查识别模式是否有问题 4.少量错误重新获取验证码参数重试即可 |
| retry 1024| 重新获取验证码参数 重试即可 |
~~~
~~~
# 其他
`handle_method` 参数如何选择 正常识别模式 还是 离线识别模式
例如获取到的验证码是
```
{
"challenge": "3c6bcdc5d7e6931c99ac8ee0275b82bd",
"gt": "0fba0b033efa9acc9465cf51bbab9698",
"success": 1
}
```
其中`success`属性 如果是 1 使用 `three_on` 第三代正常识别模式
如果`success`属性 如果是 0 使用 `three_off` 第三代离线识别模式
一般来说使用 `three_on` 即可
再举一个例子
```
{
"challenge":"0qk08iihzrhiz5gdtu3zjf0rfaylti08",
"gt":"f7ade3c71a5c32f8ed3ca17a87f27bae",
"new_captcha":true,
"success":0,
"timestamp":1606718100
}
```
这里的 success 是 0 所以要使用第三代离线识别模式