API文档
本文档详细介绍了如何使用CAPTCHA解析专家的API服务来识别各类验证码。我们的API采用RESTful设计,支持多种编程语言。
介绍
CAPTCHA解析专家API为您提供强大的验证码识别功能,支持多种类型的验证码,包括:
- 普通图形验证码 (文字、数字、计算题)
- 滑动验证码 (获取准确的滑动距离)
- 点选验证码 (图片对象识别与定位)
- 空间推理验证码 (3D物体旋转等)
我们的API会不断更新以支持新型验证码,确保您的业务不会因为验证码更新而受阻。
身份验证
所有API请求都需要使用您的API密钥进行身份验证。您可以在控制台中查看和管理您的API密钥。
在每个请求中,您需要在请求头中包含您的API密钥:
Authorization: Bearer YOUR_API_KEY
请妥善保管您的API密钥,不要将其泄露给他人或嵌入到公共客户端代码中。
请求限制
根据您的套餐级别,API请求会有不同的限制:
套餐 | 每月请求限制 | 并发请求数 | 每秒请求数(QPS) |
---|---|---|---|
基础版 | 10,000 | 5 | 10 |
专业版 | 50,000 | 20 | 50 |
企业版 | 200,000 | 无限制 | 200 |
当您超出请求限制时,API将返回429状态码。
错误处理
API使用HTTP状态码表示请求的状态。下面是常见的状态码:
状态码 | 说明 |
---|---|
200 OK | 请求成功 |
400 Bad Request | 请求参数有误 |
401 Unauthorized | 身份验证失败或API密钥无效 |
403 Forbidden | 权限不足,可能是套餐限制 |
429 Too Many Requests | 请求频率超出限制 |
500 Internal Server Error | 服务器内部错误 |
错误响应示例:
{
"error": {
"code": "invalid_image",
"message": "无法处理提供的图片,请确保图片格式正确且清晰可见",
"status": 400
}
}
图形验证码识别
POST
/api/v1/captcha/image
识别普通的图形验证码,包括字母、数字、汉字和计算题。
请求参数
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
image | file/base64 | 是 | 验证码图片文件或base64编码的图片数据 |
type | string | 否 | 验证码类型,可选值:auto(默认), number, alphabet, chinese, calculation |
响应
{
"success": true,
"data": {
"text": "A1B2C3",
"confidence": 0.98,
"processing_time": 0.25
}
}
示例代码
import requests
import base64
# 加载图片文件
with open('captcha.png', 'rb') as image_file:
encoded_string = base64.b64encode(image_file.read()).decode('utf-8')
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
data = {
'image': encoded_string,
'type': 'auto'
}
response = requests.post(
'https://api.captchaexpert.com/api/v1/captcha/image',
headers=headers,
json=data
)
result = response.json()
print(result['data']['text'])
需要完整的API文档和示例代码?
注册获取完整文档