ReCAPTCHA
概述
Google reCAPTCHA 是世界上最受欢迎的验证码系统，被数百万网站用于防止垃圾邮件和机器人。Achicaptcha 目前支持 reCAPTCHA v2，成功率很高。
⚠️
目前 Achicaptcha 仅支持 reCAPTCHA v2。尚不支持 reCAPTCHA v3 和 Enterprise。
1. 创建任务
请求
POST https://api.achicaptcha.com/createTask
参数
| 参数名称 | 数据类型 | 是否必需 | 描述 |
|---|---|---|---|
clientKey | string | 是 | Api 密钥 |
task.type | string | 是 | RecaptchaV2TaskProxyless 用于超快速解决 RecaptchaV2TaskProxylessNormal 用于正常解决 |
task.websiteURL | string | 是 | 包含验证码的网站 URL |
task.websiteKey | string | 是 | reCAPTCHA 站点密钥 |
请求示例
POST /createTask HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "RecaptchaV2TaskProxyless",
"websiteURL": "https://www.google.com/recaptcha/api2/demo",
"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"
}
}响应
成功时，服务器返回 errorId = 0 和 taskId
{
"errorId": 0,
"taskId": "f2fc70d6-c76b-4fba-9480-205ac1fe9fb9"
}2. 获取结果
请求
POST https://api.achicaptcha.com/getTaskResult
参数
| 参数名称 | 数据类型 | 是否必需 | 描述 |
|---|---|---|---|
clientKey | string | 是 | Api 密钥 |
taskId | string | 是 | 从 (1) 获得的 TaskId |
请求示例
POST /getTaskResult HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"taskId": "f2fc70d6-c76b-4fba-9480-205ac1fe9fb9"
}响应
{
"errorId": 0,
"status": "ready",
"solution": "03AGdBq27QGA96FJRo3mtz..."
}状态说明
errorId = 0且status = ready：成功解决，从solution中读取结果errorId = 0且status = processing：正在解决验证码，等待 2 秒后重试errorId > 0：系统错误，返回错误代码和描述
集成示例
import requests
import time
def solve_recaptcha_v2(website_url, website_key, api_key='YOUR_API_KEY'):
# 步骤 1：创建任务
create_task_url = 'https://api.achicaptcha.com/createTask'
create_task_payload = {
'clientKey': api_key,
'task': {
'type': 'RecaptchaV2TaskProxyless',
'websiteURL': website_url,
'websiteKey': website_key
}
}
response = requests.post(create_task_url, json=create_task_payload)
result = response.json()
if result['errorId'] != 0:
raise Exception(result['errorDescription'])
task_id = result['taskId']
# 步骤 2：获取结果
get_result_url = 'https://api.achicaptcha.com/getTaskResult'
while True:
time.sleep(2) # 等待 2 秒
get_result_payload = {
'clientKey': api_key,
'taskId': task_id
}
response = requests.post(get_result_url, json=get_result_payload)
result = response.json()
if result['errorId'] != 0:
raise Exception(result['errorDescription'])
if result['status'] == 'ready':
return result['solution']
# 如果 status == 'processing'，继续循环
# 使用方法
website_url = 'https://www.google.com/recaptcha/api2/demo'
website_key = '6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-'
token = solve_recaptcha_v2(website_url, website_key, 'YOUR_API_KEY')
print('reCAPTCHA 令牌:', token)常见错误码
| 错误码 | 描述 | 备注 |
|---|---|---|
| 0 | 成功 | 成功 |
| 1 | 处理中 | 处理中 |
| 2 | 缺少必填字段 | 缺少必填字段，请再次检查参数 |
| 3 | 不支持的任务 | 不支持的任务类型 |
| 4 | 任务创建失败 | 任务创建失败 |
| 5 | 客户端密钥不存在 | API 密钥不存在，请再次检查 API 密钥 |
| 6 | 账户余额不足 | 账户余额不足，请添加更多积分 |
| 7 | 任务失败，请创建新任务 | 任务失败，请创建新任务 |
| 8 | 任务 ID 不存在 | 任务 ID 不存在 |
最佳实践
为了在使用 Achicaptcha API 时获得最佳结果，请遵循以下原则：
1. 验证站点密钥
- 在发送请求之前检查站点密钥
- 确保从
data-sitekey属性获得的站点密钥准确 - 验证网站 URL 与包含验证码的页面匹配
2. 处理超时
- 令牌有过期时间（通常为 120 秒）
- 收到令牌后立即使用
- 不要长时间缓存令牌
3. 轮询间隔
- 在结果检查之间至少等待 2 秒
- 不要用太多连续请求向 API 发送垃圾信息
- 设置超时以避免无限循环（建议 120 秒）
4. 重试逻辑
- 对临时错误（如
ERROR_NO_SLOT_AVAILABLE）实施重试 - 重试时使用指数退避
- 限制最大重试次数
5. API 密钥安全
- 不要在代码中硬编码 API 密钥
- 使用环境变量
- 不要在客户端暴露 API 密钥
有用链接：