API文档

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文档和示例代码?

注册获取完整文档