Skip to content
API
Facebook验证码

Facebook 验证码

概述

Facebook 验证码是Facebook用于防止垃圾邮件、机器人和不需要的自动化活动的安全系统。这是一种具有Facebook独特字体的文本验证码。

📘

Facebook 验证码通常在登录、注册新账户或当Facebook检测到您的账户存在异常活动时出现。

Facebook Captcha

1. 创建请求

请求

POST https://api.achicaptcha.com/createTask

参数

参数名称数据类型是否必需描述
clientKeystringAPI密钥
task.typestringImageToTextTask
task.imagestringFacebook验证码图片的base64编码
task.subTypestringfacebook

请求示例

POST /createTask HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json
 
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ImageToTextTask",
    "image": "base64 encoded Facebook captcha image",
    "subType": "facebook"
  }
}

响应

成功时,服务器返回 errorId = 0taskId

{
  "errorId": 0,
  "taskId": "f2fc70d6-c76b-4fba-9480-205ac1fe9fb9"
}

2. 获取结果

请求

POST https://api.achicaptcha.com/getTaskResult

参数

参数名称数据类型是否必需描述
clientKeystringAPI密钥
taskIdstring从(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": "2m7k8x"
}

状态说明

  • errorId = 0status = ready:成功解决,在 solution 中读取结果
  • errorId = 0status = processing:正在解决验证码,等待2秒后重试
  • errorId > 0:系统错误,返回错误代码和描述

集成示例

import requests
import time
import base64
 
def solve_facebook_captcha(image_path, api_key='YOUR_API_KEY'):
    # 读取并编码图片
    with open(image_path, 'rb') as image_file:
        image_base64 = base64.b64encode(image_file.read()).decode('utf-8')
    
    # 步骤1:创建任务
    create_task_url = 'https://api.achicaptcha.com/createTask'
    create_task_payload = {
        'clientKey': api_key,
        'task': {
            'type': 'ImageToTextTask',
            'image': image_base64,
            'subType': 'facebook'
        }
    }
    
    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',继续循环
 
# 使用方法
solution = solve_facebook_captcha('facebook_captcha.png', 'YOUR_API_KEY')
print('Facebook验证码结果:', solution)

常见错误代码

错误代码描述备注
0成功成功
1处理中处理中
2缺少必填字段缺少必填字段,请再次检查参数
3不支持的任务不支持的任务类型
4任务创建失败任务创建失败
5客户端密钥不存在API密钥不存在,请再次检查API密钥
6账户余额不足账户余额不足,请充值
7任务失败,请创建新任务任务失败,请创建新任务
8任务ID不存在任务ID不存在

最佳实践

为了在使用Achicaptcha API时获得最佳结果,请遵循以下原则:

1. 图片质量

  • 使用高分辨率图片
  • 确保图片不过于模糊或有噪点
  • 正确捕获或裁剪Facebook验证码区域

2. 轮询间隔

  • 在结果检查之间至少等待2秒
  • 不要用过多连续请求轰炸API
  • 设置超时以避免无限循环

3. 重试逻辑

  • 对临时错误(如 ERROR_NO_SLOT_AVAILABLE)实施重试
  • 重试时使用指数退避
  • 限制最大重试次数

4. API密钥安全

  • 不要在代码中硬编码API密钥
  • 使用环境变量
  • 不要在客户端暴露API密钥

有用的链接: